Wensity CLI
Install open-code components and UI primitives from the Wensity registry into your project. There is no @wensity/ui runtime dependency and no theme provider to wire up.
npx wensity@latest init
npx wensity@latest init --preset <wsty1-code>
npx wensity@latest init --preset <wsty1-code> --template next
npx wensity@latest apply --preset <wsty1-code>
npx wensity@latest preset inspect <wsty1-code>
npx wensity@latest add button
npx wensity@latest add liquid-multimodal-input
Presets (primitives)
Generate a preset in the Create preset studio (guide: /docs/create-preset). Then run init --preset (new project) or apply --preset (existing). Settings land in wensity.json (style.iconLibrary, radius, fonts, control-solid colors) and a delimited --primitive-* CSS block in your Tailwind CSS file.
Later wensity add <primitive> / wensity update <primitive> reads that style automatically:
- Colors, radius, and fonts re-apply into the CSS block
- Tabler ↔ Lucide icon imports transform at install time for UI primitives only
- Mandatory dependency swap installs exactly one icon package when icons are used
Plain init (no --preset) refuses to overwrite an existing wensity.json unless you pass --force. Prefer apply --preset for style-only updates; init --preset also merges style (+ CSS) without rewriting installed component source.
Commands
wensity init [--preset <code>] [--template next|vite|astro|react-router] | Create / merge project config |
wensity apply --preset <code> | Apply style + CSS to an existing project |
wensity preset inspect <code> | Decode a preset code |
wensity login | Save a dashboard API token for Pro |
wensity logout | Clear credentials |
wensity whoami | Show current user / plan |
wensity list | List registry entries |
wensity add <slug> | Install source (skips existing files) |
wensity update <slug> | Re-download and overwrite local source |
wensity version | Print 0.1.9 |
Premium components and blocks require an API token from the Wensity dashboard. Tokens are stored at ~/.config/wensity/credentials.json with 0600 permissions.
CLI vs shadcn
Stored presets (wensity.json style) | Yes | No |
| Lucide delivery | Yes (CLI transform) | No — Tabler-canonical payloads |
| Full editable source | Yes | Yes |
@wensity/ui runtime | Never | Never |
Premium /components | Token + license | Not exported |
Docs: CLI reference · Create preset · Primitives