# File Browser — BrandApp Playground

> A complete file manager UI — nested folders, upload queue, rename, move, preview, usage — on the Files API.

- Canonical page: https://brandapp-playground.vercel.app/files/browser
- Markdown: https://brandapp-playground.vercel.app/files/browser.md
- SDK module: `@reopt-ai/brandapp-sdk/files`

## What it is

`@reopt-ai/opt-filemanager` mounted on the BrandApp Files API through server-side proxy
routes, so no credential ever reaches the browser. Covers nested folders, an upload queue,
rename and move, text preview, deletion, and storage usage.

## Proxy routes

| Route | Purpose |
| --- | --- |
| `GET /api/files` | list files |
| `POST /api/files/upload` | upload |
| `GET /api/files/{fileId}` | metadata |
| `PATCH /api/files/{fileId}` | rename or move |
| `DELETE /api/files/{fileId}` | delete |
| `GET /api/files/{fileId}/content` | text preview |
| `GET \| POST /api/files/folders` | list or create folders |
| `PATCH \| DELETE /api/files/folders/{folderId}` | rename or delete a folder |
| `GET /api/files/usage` | storage usage |

The repository ships a longer reference at `docs/file-browser.md` covering installation,
architecture, the capability and endpoint maps, limits, errors, and compatibility.

## Related

- [Files API](https://brandapp-playground.vercel.app/files.md)
- [File Hooks](https://brandapp-playground.vercel.app/hooks/files.md)

---

Index of every document: https://brandapp-playground.vercel.app/llms.txt
Single-file copy: https://brandapp-playground.vercel.app/llms-full.txt
HTTP API description: https://brandapp-playground.vercel.app/openapi.json