ionbit-ui

Ionbit UI CLI

A CLI for installing Ionbit UI components into your React project.

Quick start

npx ionbit-ui@latest init
npx ionbit-ui@latest add button

Commands

init

Initialize Ionbit UI in your project. Creates a config file, sets up directories, installs base utilities and design tokens, and adds CSS imports.

npx ionbit-ui@latest init

Options:

• --yes — skip confirmation prompts and use defaults
• --force — force overwrite of existing configuration
• --pointer — add cursor: pointer to buttons (Tailwind v4 changed the default)

add <component...>

Install one or more components from the registry. Automatically resolves transitive dependencies and installs npm packages.

npx ionbit-ui@latest add button
npx ionbit-ui@latest add dialog accordion glow

Options:

• --overwrite — overwrite existing files

list

List all available components in the registry.

npx ionbit-ui@latest list

theme [id]

Install a preset theme or a custom theme. The command writes theme.css to the configured styles directory and adds it to the configured global CSS file.

npx ionbit-ui@latest theme nord
npx ionbit-ui@latest theme banana-cake
npx ionbit-ui@latest theme --custom '<theme-json>'

Options:

• --custom <json> — install a custom theme configuration generated by the docs theme editor
• --overwrite — replace an existing theme.css

Package manager support

The CLI auto-detects your package manager from lockfiles and uses the correct install command:

Package manager	Lockfile	Install command
pnpm	pnpm-lock.yaml	pnpm add
npm	(default)	npm install
yarn	yarn.lock	yarn add
bun	bun.lockb / bun.lock	bun add

Requirements

• Node.js >= 20
• React 18+
• Tailwind CSS v4

License

MIT