Skip to content

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.json

Each 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 @davinciui entry in your components.json and expands {name} to text-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-morph

What 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 --overwrite

Overwrite 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-morph

Assistants 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 registries block is missing from components.json. Re-add it per Configuration.
  • Wrong slug — item names are exact and kebab-cased. Copy the slug from the component page or view it first.
  • Dependency install fails — finish with your own package manager, then restart the dev server.
  • Files in the wrong place — aliases disagree with tsconfig.json paths; see Installation → Common problems.