# Registry structure

```text
app/                 Documentation website
components/ui/       Installable component source
components/library/  Documentation previews
lib/                 Shared utilities and catalogs
public/r/            Generated registry payloads
registry.json        Registry source of truth
components.json      Local shadcn configuration
```

When adding an installable component:

1. Add its source to `components/ui`.
2. Declare the item and dependencies in `registry.json`.
3. Add its documentation metadata to `lib/catalog.ts`.
4. Add a preview and example source.
5. Build and validate the registry.