tools do browser - BevvyTech/BrewskiDocs GitHub Wiki

Tools – DO Browser (/tools/do-browser)

Purpose

  • Offer super users a read-only view of DigitalOcean Spaces assets to support troubleshooting uploads and generated documents.
  • Keep storage inspections inside the admin console so operators do not need to jump to external tooling for quick checks.

Data & Permissions

  • Available only to members of a super-user team; non privileged users are redirected back to /tools.
  • Requests file metadata through the internal DO browser service, which exposes directories and files with paginated responses.
  • Preview requests are limited to moderate payload sizes and never allow mutation or deletion.

Key Interactions

  • Breadcrumb navigation mirrors the current path; a dedicated back button jumps one level up when not viewing the root.
  • The file table renders folders first followed by files, includes human-friendly size and modified timestamps, and paginates using the shared admin pattern.
  • Clicking a folder drills into that prefix; clicking a file opens a dialog that streams a preview (image, PDF, JSON with pretty-printing, or plain text) and offers an “open in new tab” action for other formats.
  • Refresh control re-validates the listing against Spaces without altering the current path or pagination settings.
  • The current path and pagination state are mirrored in the query string so reloading or sharing the URL returns to the same folder view.
⚠️ **GitHub.com Fallback** ⚠️