Docs
Registry
Every DavinciUI component ships as a registry item — a JSON file the shadcn CLI resolves, downloads, and copies into your project. No npm package, no version lock. You own the code.
What the registry contains#
registry.json lists every available item with its name, files, and dependencies:
https://davinciui.com/r/registry.jsonEach item also has its own file at /r/[name].json — e.g. /r/text-morph.json. An item declares the component source files to copy, the npm packages they need (for example framer-motion or lucide-react), and a description. Nothing executes on DavinciUI's servers — the JSON only describes what to copy.
How the CLI resolves a registry item#
- You run
pnpm dlx shadcn@latest add @davinciui/text-morph. - The CLI reads the
@davinciuientry in yourcomponents.jsonand expands{name}totext-morph. - It downloads
https://davinciui.com/r/text-morph.json, copies the listed files into your aliased directories, and installs the listed dependencies.
Resolution is per-install and network-dependent: the CLI fetches the item JSON at install time, so an offline machine cannot add new components (already-installed files keep working).
Registry namespace configuration#
The namespace scopes third-party registries so names never clash with your local components or other registries. Add it to components.json (see Configuration):
{
"registries": {
"@davinciui": "https://davinciui.com/r/{name}.json"
}
}Installable source and dependencies#
Pick a component from Components and add it under the @davinciui namespace:
pnpm dlx shadcn@latest add @davinciui/text-morphWhat you get: the component file under @/components/ui, plus its declared npm dependencies installed into your project. Each component page lists its own requirements — check them before adding animation- or canvas-heavy pieces.
See CLI for npm / yarn / bun variants and Installation for project setup.
Updating an installed component#
Installed source does not update automatically. To pick up a newer registry version, re-run add with --overwrite:
pnpm dlx shadcn@latest add @davinciui/text-morph --overwriteOverwrite replaces your local files, so commit first and re-apply any customizations afterwards.
Reading or inspecting registry JSON#
Open any item URL in the browser, or preview it without installing:
pnpm dlx shadcn@latest view @davinciui/text-morphAssistants can read the whole registry as plain text via /llms.txt, install the DavinciUI skill, or install through the MCP server.
Troubleshooting failed installs#
- 404 or unknown registry — the
registriesblock is missing fromcomponents.json. Re-add it per Configuration. - Wrong slug — item names are exact and kebab-cased. Copy the slug from the component page or
viewit first. - Dependency install fails — finish with your own package manager, then restart the dev server.
- Files in the wrong place — aliases disagree with
tsconfig.jsonpaths; see Installation → Common problems.

