wensity

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.

# Initialise (defaults: Tabler icons, medium radius)
npx wensity@latest init

# Or apply a shareable preset from https://ui.wensity.com/docs/primitives/setup
# Preset support requires wensity 0.1.8 or later
npx wensity@latest init --preset <wsty1-code>

# Install a primitive or component
npx wensity@latest add button
npx wensity@latest add liquid-multimodal-input

Presets (primitives)

Generate a preset on /docs/primitives/setup, then run the copied init --preset command once. 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. init --preset merges style (+ CSS) into an existing config without rewriting installed component source.

Commands

Command	Purpose
wensity init [--preset <code>]	Create / merge project config
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.8

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

	Wensity CLI	Public shadcn registry (@wensity/*)
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 · Primitive setup · Primitives