Skip to content

Agents & tools

CLI & registry.

Every Sundae asset is published as a shadcn-compatible registry item, so the CLI you may already use installs it. No extra tool required.

Free assets

Pass the asset’s registry URL. No account is needed.

$npx shadcn@latest add https://sundaeui.dev/r/taffy-tabs.json

Pro assets

  1. Create a personal token in your account and store it as an environment variable, for example SUNDAE_TOKEN in .env.local.
  2. Register Sundae as a namespaced registry in components.json. The CLI sends the header with every request and expands ${SUNDAE_TOKEN} from your environment.
components.json
{
  "registries": {
    "@sundae": {
      "url": "https://sundaeui.dev/r/{name}.json",
      "headers": { "Authorization": "Bearer ${SUNDAE_TOKEN}" }
    }
  }
}
$npx shadcn@latest add @sundae/command-palette

The server checks the token’s account for an active Pro subscription on every request. Without a token you get 401, and without an active subscription you get 403, with a message saying why. Tokens can be revoked at any time from your account.

Item format

Items follow the shadcn registry-item.json schema. Every file targets components/sundae/, and meta.sundae carries the catalog number, version, tier and license URL.