# File Storage File List

Document listing with per-row actions.

- id: `file-storage-file-list`
- Page: https://agentic-ui-kit.com/components/file-storage-file-list
- Live preview: https://agentic-ui-kit.com/live/template/file-storage/collections/c1?piece=file-storage-file-list

## Install

```bash
agentic-ui add file-storage-file-list
npx shadcn@4.17.0 add @agentic-ui/file-storage-file-list
```

## Metadata

- **Level:** block
- **Category:** block
- **Template:** Stashbox File Storage
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** list-grid-gallery-views, row-actions, starring, context-menu, selection
- **Intents:** manage-collection, explore-detail
- **Suits domains:** file-storage, media, ecommerce, crm, knowledge
- **Interaction:** view-switching, row-actions, starring, selection
- **Screen role:** management
- **Density:** compact
- **Dark mode:** yes
- **Use it for:** Document listing with per-row actions, Switchable image gallery, CRM attachments table
- **Avoid when:** Server-side pagination is needed, The items are not files or assets
- **Preserve when adapting:** information-hierarchy, interaction-model
- **Replace when adapting:** domain-copy, mock-data, semantic-tokens, domain-formatting
- **Adaptation effort:** medium
- **Coupling:** high
- **Quality score:** 7.6/10
- **Quality breakdown:** visual 9/10, responsive 8/10, accessibility 6/10, code 8/10
- **Uses primitives:** button, badge, dropdown-menu
- **npm dependencies:** lucide-react, next/image
- **Used in:** Stashbox File Storage (template)
- **npm dependencies (registry):** lucide-react@0.577.0, zustand@5.0.8
- **Registry dependencies:** file-storage-file-detail-panel, lib-file-storage-utils, ui-badge, ui-button, ui-dropdown-menu