# Documentation

- Getting Started
  - [Introduction](/docs/getting-started): A shadcn-style file UI component library. Copy-paste components for the complete file experience.
  - [Installation](/docs/getting-started/installation): How to install and set up Shelf UI components in your project.
  - [Theming](/docs/getting-started/theming): How Shelf UI's CSS variable system works — token reference, light/dark modes, and how to customize every token to match your brand.
  - [Skills](/docs/getting-started/skills): Give your AI coding assistant full knowledge of Shelf UI — so it installs, composes, and customizes components correctly on the first try.
  - [MCP Server](/docs/getting-started/mcp): Connect Shelf UI to AI assistants via the Model Context Protocol — so your assistant can query components, generate install commands, and browse the registry directly.
  - [LLMs](/docs/getting-started/llms): How to consume Shelf UI documentation via Large Language Models.
- Upload
  - [Dropzone](/docs/uploads/dropzone): A headless drag-and-drop zone with upload state management, validation, and retry logic.
- Preview & Display
  - [FileCard](/docs/display/file-card): A composable row for displaying a single file's upload status, progress, and actions.
  - [Patterns](/docs/display/patterns): Common upload UI compositions built entirely from Dropzone and FileCard — no extra components required.
  - [AttachmentChip](/docs/display/attachment-chip): A compact inline pill for displaying a file attachment with an icon, filename, and optional remove button.
- Management
  - [FileTree](/docs/management/file-tree): A recursive folder and file browser with expand/collapse, keyboard navigation, and selection.
  - [FileBreadcrumb](/docs/management/file-breadcrumb): A path navigation bar that renders a clickable breadcrumb trail for folder hierarchies.
- Adapters
  - [Supabase Storage](/docs/adapters/supabase): Use Shelf UI components with Supabase Storage for seamless file uploads.
  - [AWS S3](/docs/adapters/aws-s3): Integrate Shelf UI components with Amazon S3 for scalable file storage.
  - [Cloudinary](/docs/adapters/cloudinary): Use Shelf UI with Cloudinary for advanced image and video management.