Skip to Content
Get full access

Install

Components install directly into your project through the shadcn CLI. You own the source, so edit and customize it freely.

Requirements

  • Next.js 16 or later and React 19, with shadcn/ui initialized (npx shadcn@latest init).
  • Tailwind CSS v4.
  • Nothing else for the free components. Licensed components need a license; see Pricing.

Install free components

Add the registry to the components.json shadcn created at your project root. No token, no account:

components.json
{
  "registries": {
    "@01orbital": "https://01orbital.dev/r/{name}.json"
  }
}

Then install by name:

npx shadcn@latest add @01orbital/button

Install licensed components

A one-time setup lets the CLI send your license token with every install.

Add your token to .env.local

Your token arrived by email after purchase. Paste it into your project's .env.local:

.env.local
ORBITAL_TOKEN=your_token_here

Add the token to the registry entry

The same @01orbital entry, with the header added:

components.json
{
  "registries": {
    "@01orbital": {
      "url": "https://01orbital.dev/r/{name}.json",
      "headers": { "Authorization": "Bearer ${ORBITAL_TOKEN}" }
    }
  }
}

Install any licensed component

npx shadcn@latest add @01orbital/split-hero-02

The CLI sends your token automatically. Components land where your shadcn config says, usually components/.

Troubleshooting

401 Unauthorized

Either ORBITAL_TOKEN isn't set in .env.local, or your shell didn't pick up the new variable. Restart your dev server or terminal after editing the env file. To have your token emailed again, enter your purchase email at /account.

404 Not Found

The component name is wrong. Each docs page shows the exact install command.

Token leaked

Email us at hello@01orbital.dev and we'll rotate it.