App requirements
Before you begin, make sure your project meets these requirements:
Automatic installation
Initialize
Run this in your project root. It scaffolds the shadcn CLI, installs the design tokens, and registers dotUI in your components.json so components resolve to it.
npm
pnpm
yarn
bun
npx shadcn@latest init https://dotui.org/r/initThis writes the @dotui registry into components.json:
{
"registries": {
"@dotui": "https://dotui.org/r/{name}?preset="
}
}The empty ?preset= is a placeholder — a style exported from the editor fills it in so every component installs pre-themed.
Building a style in the editor? Its export dialog gives you an
init command with your theme baked in, so every component installs
pre-styled to your system.
Add components
You can now add any component to your project.
npm
pnpm
yarn
bun
npx shadcn@latest add @dotui/buttonYou're done!
Last updated on 7/22/2026