Installation

Premium components ship through a private shadcn registry. Register it once, set your token, and install any component or block straight into your app — fully typed, with its dependencies resolved for you.

  • A beUI Pro license token (BEUI_PRO_TOKEN)
  • The shadcn CLI — no global install needed, just npx / bunx
  • React 19, Next.js, and Tailwind CSS v4

1. Get your token

Your BEUI_PRO_TOKEN lives on your account page. It maps to your license and never expires while your plan is active — only its hash is ever stored on our side.

2. Register the registry

Add the @beui-pro registry to your project's components.json, beside the free public @beui registry that premium blocks build on.

JSONcomponents.json
{
  "registries": {
    "@beui": "https://beui.dev/r/{name}.json",
    "@beui-pro": {
      "url": "https://pro.beui.dev/r/{name}.json",
      "headers": {
        "Authorization": "Bearer ${BEUI_PRO_TOKEN}"
      }
    }
  }
}

3. Set your token

The registry reads your token from the BEUI_PRO_TOKEN environment variable. Export it, or prefix a single command with it.

# Set it once for your shell session
export BEUI_PRO_TOKEN="beui_live_xxxxxxxxxxxx"

# …or pass it inline for a single install
BEUI_PRO_TOKEN="beui_live_xxxxxxxxxxxx" npx shadcn@latest add @beui-pro/agent-chat-input

4. Install a component

Run the CLI with the namespaced slug. Every component page lists its exact command — here it is for a few of them.

$ bunx --bun shadcn add @beui-pro/studio-background

Prefer not to touch components.json? Point the CLI at the authenticated URL directly.

npx shadcn@latest add https://pro.beui.dev/r/agent-chat-input.json

Manual install

Want the raw source instead of the CLI? Fetch the registry item with your token — the JSON response carries every file's contents, its dependencies, and the target paths. Copy them into your project by hand.

# Fetch the registry item — the JSON includes every source file
curl -H "Authorization: Bearer $BEUI_PRO_TOKEN" \
  https://pro.beui.dev/r/agent-chat-input.json

The component's files array maps each source file to its destination, and registryDependencies lists the public @beui primitives it relies on.

Need a hand?

Browse the component library — each page ships a live preview, usage snippet, and its own install command.