Pro setup

Pro items come from a private registry. The shadcn CLI sends your personal key with each request, and the files land in your project like any other item. Free items (Lumen Nav, Lumen Stat and the other free pieces) need none of this: install them straight from their URL.

1. Create a key

Sign in at your account with the email you bought with, name the key (for example “Laptop” or “CI”) and select Create key. Copy it right away; it is only shown once. You can keep up to 10 keys and revoke any one of them without touching the others.

2. Store it in your environment

BEAUTIFUL_UI_TOKEN=fmm_your_key_here

Keep .env.local out of git. The shadcn CLI loads it automatically and expands ${BEAUTIFUL_UI_TOKEN} in components.json.

3. Configure the registry

{
  "registries": {
    "@beautiful-ui": "https://beautiful-ui.dev/r/{style}/{name}.json",
    "@beautiful-ui-pro": {
      "url": "https://beautiful-ui.dev/r/pro/{style}/{name}.json",
      "headers": { "Authorization": "Bearer ${BEAUTIFUL_UI_TOKEN}" }
    }
  }
}

4. Install

npx shadcn@latest add @beautiful-ui-pro/lumen-market-breadth @beautiful-ui-pro/lumen-flow-funnel

Prefer a license-key header? The registry also accepts "headers": { "X-License-Key": "${BEAUTIFUL_UI_TOKEN}" }. Every item's AI guide is published at https://beautiful-ui.dev/md/<name>.md, and npx shadcn@latest add https://beautiful-ui.dev/r/beautiful-ui-ai.json installs the agent rules for your AI tools.

Teams

An All-Access Lifetime license covers up to 10 developers. Invite teammates from your account; each person signs in with their own email and creates their own token, so you can remove someone without affecting anyone else.

CI and deploys

You only need the token when you add or update items, not to build or run your app: the source is already in your repo. If a script in CI runs the shadcn CLI, create a separate “CI” key and add it as the BEAUTIFUL_UI_TOKEN secret, so you can revoke it on its own.

Troubleshooting

• 401 License key missing: BEAUTIFUL_UI_TOKEN is not set in the shell or .env.local, or the registry is missing from components.json.
• 403 Key not recognised: the key was revoked or mistyped. Create a fresh one in your account.
• 403 Not included: your purchase does not cover this piece. The message names the pack, theme or plan that does.
• 402 Pro item: you used @beautiful-ui for a Pro item. Use @beautiful-ui-pro.

Still stuck? Email support@beautiful-ui.dev.