CLI and API keys

Free components install by URL. No account needed.

npx shadcn@latest add https://lodeui.com/r/button.json

Pro components are served only to requests that carry a key backed by an active license. Create one in Dashboard → API keys.

• Personal keys (lode_…) use your own license. Create one per machine or tool so you can revoke them separately.

We only store a hash of each key, so copy it when you create it. Keys can expire and can be revoked at any time.

Add the registry to components.json. The CLI expands the environment variable and sends it as a header.

{
  "registries": {
    "@lode": {
      "url": "https://lodeui.com/r/{name}.json",
      "headers": {
        "Authorization": "Bearer ${LODE_API_KEY}"
      }
    }
  }
}

LODE_API_KEY=lode_your_key_here

npx shadcn@latest add @lode/area-chart

Store a key you create for CI as a secret and expose it as LODE_API_KEY.

- name: Install UI components
  run: npx shadcn@latest add @lode/donut-chart --yes
  env:
    LODE_API_KEY: ${{ secrets.LODE_API_KEY }}

401

No key, or the key is invalid, expired or revoked.

402

The key is valid but has no active Pro license behind it.

429

Rate limit: 120 requests per minute per key.