1

CLI

Initialize projects and install Ondo registry items from the terminal.

The Ondo CLI wraps the shadcn CLI with Ondo's registry and framework setup.

Install

Run the CLI without installing it globally:

bunx --bun @dou.so/ondo-ui@latest --help

Initialize a project

Create or initialize a supported framework and configure the Ondo registry:

bunx --bun @dou.so/ondo-ui@latest init -t astro

Supported frameworks are Next.js, Vite, TanStack Start, React Router, Laravel, and Astro. The command installs the framework-compatible Ondo theme and adds the @ondo-ui registry to components.json.

For an existing project, use the same command with --cwd:

bunx --bun @dou.so/ondo-ui@latest init -t vite --cwd ../my-vite-app

An existing app must already have Tailwind CSS v4 wired into its build and a working @/* import alias — shadcn's preflight validates both, and init does not create them. Each framework guide's Existing Project section lists the exact steps.

Add registry items

Open the grouped Components and Compositions menu:

bunx --bun @dou.so/ondo-ui@latest add

Install items directly or install every selectable item:

bunx --bun @dou.so/ondo-ui@latest add button empty-view
bunx --bun @dou.so/ondo-ui@latest add --all
bunx --bun @dou.so/ondo-ui@latest add -a
bunx --bun @dou.so/ondo-ui@latest add button --dry-run

System items such as theme-provider can be installed by explicit name but do not appear in the default menu.

Common add options

OptionPurpose
--all, -aInstall every Component and Composition shown in the menu.
--dry-runPreview files and dependencies without changing the project.
--diff [path]Show the changes that would be applied.
--view [path]View registry file contents without applying them.
--cwd <path>Run against another project directory.

Names without a registry namespace are resolved as @ondo-ui/<name>. A name that is already a registry address or URL is passed through unchanged.

Command reference

Ondo supports the shadcn command surface for project and registry workflows:

init, add, search, list, view, docs, diff, apply, info, migrate, eject, mcp, preset, build, and registry.

list is an alias for search. The deprecated diff command is translated to add --diff. Use --cwd <path> to run a command for another project.

For example:

bunx --bun @dou.so/ondo-ui@latest search @ondo-ui --query button
bunx --bun @dou.so/ondo-ui@latest view @ondo-ui/button
bunx --bun @dou.so/ondo-ui@latest mcp init --client claude

Registry maintainers can use build and registry to author and validate registry files.