# Shadcn Files blocks

> File explorer, folder browsing, sharing, and storage management pages.

- Type: Pro blocks (Solutions)
- Page: https://web.dev.reui.io/blocks/solutions/files
- Blocks: 1
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## When to use

- A team drive page: a folder tree beside the open folder's contents as a list or card grid
- Shared studio or agency storage where people upload, share by link, move and restore deleted items

## When not to use

- A nested outline or folder picker alone, with no listing of the open folder beside it: use [Tree](https://web.dev.reui.io/components/tree.md) (`get_component("tree")`)
- One nested table of folders whose rows move into other folders by pointer: use the [Drag & Drop blocks](https://web.dev.reui.io/blocks/data-grid/drag-drop.md)
- A drop zone or picker for attachments inside a form, with no drive to browse: use [File Upload](https://web.dev.reui.io/components/file-upload.md) (`get_component("file-upload")`)

## Agent notes

- page.tsx wraps each block in an `h-svh` `main` with padding and the block fills it with `h-full`; inside an app shell give it a bounded height

## Third-party libraries

- TanStack Table v9: [API reference](https://tanstack.com/table/v9/docs/framework/react/reference/index), [docs](https://tanstack.com/table/v9/docs/framework/react/quick-start), used by 1 of 1 blocks
- Headless Tree v1: [API reference](https://headless-tree.lukasbach.com/api/core/), [docs](https://headless-tree.lukasbach.com/getstarted/), used by 1 of 1 blocks
- Sonner v2: [API reference](https://sonner.emilkowal.ski/toast), [docs](https://sonner.emilkowal.ski/getting-started), used by 1 of 1 blocks

## Blocks

- [Drive Explorer](https://web.dev.reui.io/blocks/solutions/files/solution-files-1.md): Drive Explorer with Folder Tree Rail and Switchable List or Grid Views. Best for a drive that acts on its files, with retryable uploads, invite and link sharing, a move picker, version history and a restorable bin.

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.