Install 01orbital

Requirements

• Next.js 16+ and React 19 with shadcn-ui already initialized (npx shadcn@latest init)
• Tailwind CSS v4
• Nothing else for the free components. Pro components need a license — see Pricing.

1. Install free components (no setup)

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

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

Then install by name:

npx shadcn@latest add @01orbital/button
npx shadcn@latest add @01orbital/card
npx shadcn@latest add @01orbital/aurora-arc-scene

Every free component is marked on /browse.

2. Install Pro components (after purchase)

Pro requires a one-time setup so the CLI sends your license token automatically with every install.

A. Add your token to .env.local

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

ORBITAL_TOKEN=your_token_here

B. Add the token to the registry entry

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

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

C. Install any Pro component

npx shadcn@latest add @01orbital/hero-10
npx shadcn@latest add @01orbital/pricing-03
npx shadcn@latest add @01orbital/features-16

The CLI sends your token automatically. Components land in your project under the path your shadcn config specifies (usually components/).

Troubleshooting

401 Unauthorized

Either ORBITAL_TOKEN isn’t set in .env.local, or your shell didn’t pick up the new var. Restart your dev server / terminal after editing the env file. You can also view your token at /account.

404 Not Found

The component name is wrong. Browse /browse to find the exact registryName for what you want.

Token leaked

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