Installation

Learn how to add dotUI to your project.

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.

npx shadcn@latest init https://dotui.org/r/init

This writes the @dotui registry into components.json:

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

Add components

You can now add any component to your project.

npx shadcn@latest add @dotui/button

You're done!

Last updated on 7/22/2026