kiteuikit CLI
The kiteuikit package adds Kite UI Kit components to your Next.js project, applies theme presets, and downloads Pro components after license validation.
Quick start
Add the CLI to your app package, then run the interactive setup (recommended):
pnpm add kiteuikit@latest -D
npx kiteuikit setupOne-off without installing: npx kiteuikit@latest setup
pnpm monorepos
apps/web). Use --workspace-root when dependencies should install at the repo root.Commands
| Prop | Type | Default | Description |
|---|---|---|---|
| setup | command | npx kiteuikit setup | Interactive wizard: optional license, pick components, choose a theme preset, install deps. |
| init | command | npx kiteuikit init [--license=KEY] | Initialize folders and dependencies without the full setup wizard. |
| add | command | npx kiteuikit add <component> | npx kiteuikit add --all | Copy component source into components/profile/. Pro components require a valid license. |
| theme | command | npx kiteuikit theme <preset> | Write a theme preset into app/globals.css and save .kiteui/theme.json. |
| activate | command | npx kiteuikit activate <license-key> | Validate and save your license key for Pro downloads. |
| status | command | npx kiteuikit status | Show license tier, activations, and which components you can add. |
| list | command | npx kiteuikit list | List all free and Pro components (and templates). |
| help | command | npx kiteuikit help | Print command reference in the terminal. |
setup
Walks through license activation (optional), component selection, and theme installation. Equivalent to running init plus add and theme in one flow.
npx kiteuikit setupinit
Creates components/profile, installs Motion and Lucide, and prints available components. Use when you only need project scaffolding.
npx kiteuikit init
npx kiteuikit init --license=KITE-XXXX-XXXX-XXXXadd
Copies component .tsx files into your project. Free components are bundled in the npm package; Pro components are fetched from GET /api/components/:name after your license is validated.
npx kiteuikit add bubble-card
npx kiteuikit add profile-header thumbnail-scroller
npx kiteuikit add --allAfter purchase
npx kiteuikit activate KITE-… or pass --license= on add. Lost your key? Sign in with email to recover licenses and invoices.theme
Writes CSS variables between /* kiteui-theme:start */ and /* kiteui-theme:end */ in app/globals.css. Saves .kiteui/theme.json for overrides. See Themes.
npx kiteuikit theme ocean
npx kiteuikit theme defaultactivate & status
activate stores your license in .kiteui-license (project or home with --global). status shows tier and activation count.
npx kiteuikit activate KITE-XXXX-XXXX-XXXX
npx kiteuikit statusFlags
| Prop | Type | Default | Description |
|---|---|---|---|
| --license=KEY | flag | — | Pass a license key inline (init, add, setup). |
| --all | flag | — | Add every component your tier allows (add only). |
| --global | flag | — | Save the license file in your home directory. |
| --workspace-root | flag | — | pnpm monorepos: install dependencies at the workspace root. |
| --theme=<preset> | flag | — | Theme preset id when running setup or theme. |
Environment variables
| Prop | Type | Default | Description |
|---|---|---|---|
| KITEUI_LICENSE | env | — | License key (alternative to .kiteui-license or activate). |
| KITEUI_API_URL | env | — | License and Pro component API base URL (default: https://kiteui.com). |
License file search order: KITEUI_LICENSE env → .kiteui-license in the project → home directory.
Free components
Shipped inside the kiteuikit npm package — no license required.
Pro components
Require a Pro, Team, or Enterprise license. Downloaded from kiteui.com when you run add. View pricing.
Templates
Full page templates (Pro tier). Add with npx kiteuikit add template-influencer. Browse layouts on Templates.