ShipUI CLI (Early Access)
You can now install ShipUI components directly into your project from the command line.
npx @voltenworks/shipui add button
That installs a production-ready Button component with variants, sizes, and link support. No config required. Works in any Next.js + Tailwind v4 project.
How It Works
Every component has two layers: a free base and optional premium theme styling.
The base install gives you the component file and a cn() utility. You write your own CSS or use Tailwind classes.
npx @voltenworks/shipui add button
Add --theme to pull in a complete design system. Theme tokens, component CSS, hover states, responsive rules. Everything that makes the component look like the demo.
npx @voltenworks/shipui add button --theme folio
Free themes (like CANDY) work without auth. Paid themes require a purchase token.
Commands
npx @voltenworks/shipui list # browse components
npx @voltenworks/shipui add <name> # install base (free)
npx @voltenworks/shipui add <name> --theme <slug> # install with theme styling
npx @voltenworks/shipui info <name> # component details
npx @voltenworks/shipui login # authenticate with purchase token
npx @voltenworks/shipui doctor # check your project setup
What's Available
15 components across 11 themes right now, with more releasing over the next two weeks. The CLI reads from a live registry, so new components appear automatically as themes launch.
Button, Badge, Card, and Text are available in 10+ themes. Theme-specific components like StatusPill (Meridian), PixelCharacter (Retro), and Calendar (Folio) are available in their respective themes.
Run npx @voltenworks/shipui list to see the full catalog.
Doctor
Not sure if your project is set up correctly? Run doctor to check.
npx @voltenworks/shipui doctor
It checks Node version, Tailwind v4, PostCSS config, CSS file paths, auth tokens, registry connectivity, and dependencies. Green checkmarks mean you're good. Warnings tell you what to fix.
Early Access
This is v0.1.5. Core install flow works. Auth works. CSS merging works. There are rough edges.
If you find a bug or something breaks, email support@voltenworks.com. Feedback on the developer experience is welcome too.
The CLI source is public at github.com/voltenworks/shipui-cli.
The Full Theme Is Still the Product
The CLI is not a replacement for buying a theme. If you want a complete starter with layouts, auth pages, and a cohesive design system, buy the theme.
The CLI is for developers who already have a project and want to pull in specific components with specific theme styling. Cherry-pick what you need.