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.