Introduction

Dots is served as a code registry. Every component and chart on this site is also a JSON file under /r/<name>.json. The shadcn CLI reads those files and writes the source into your project.

When you run init with the Dots preset, the CLI registers this site as the @dots namespace in your components.json. From then on npx shadcn@latest add @dots/<name> installs any item, together with the items it depends on.

To see what an item installs before you add it, print its payload:

pnpmnpmyarnbun
pnpm dlx shadcn@latest view @dots/button
Copy

To list or search the items in the registry:

pnpmnpmyarnbun
pnpm dlx shadcn@latest search @dots --query "field"
Copy

You can register other registries next to @dots in the registries field of components.json.