Privacy-friendly analytics only with consent. No ads, no cross-site tracking. Read the privacy policy.
Initialize a project, copy components into your own codebase, and check for drift - all from npx @slipstream-ui/cli@latest.
npx @slipstream-ui/cli@latest initnpx @slipstream-ui/cli@latest listnpx @slipstream-ui/cli@latest add messagenpx @slipstream-ui/cli@latest diff
npx @slipstream-ui/cli@latest init [options]
Initialize Slipstream UI in your project. Detects your framework (Next.js, Vite) and Tailwind setup, writes slipstream.config.json, creates the component directory, and injects theme CSS variables into your global stylesheet when it can find one.
-d, --defaults Skip the interactive flow and use default configuration. Also allows re-running init when slipstream.config.json already exists.npx @slipstream-ui/cli@latest init --defaults
npx @slipstream-ui/cli@latest add <component> [options]
Copy a component's real source files, the sibling components it imports, the shared utils, and its COMPONENT_MANIFEST into components/slipstream/. You own the code after it lands - edit it freely.
-o, --overwrite Replace existing copies of the component and its dependencies. Without it, existing files are skipped.--dry-run Print every file that would be created, overwritten or skipped, and write nothing. Use it before adding into an existing design system.npx @slipstream-ui/cli@latest add message --dry-run
npx @slipstream-ui/cli@latest list [options]
Print every available component with its id, package, and tier. Useful before running add.
-p, --package <package> Filter by package (core, ai, themes).-t, --tier <tier> Filter by tier (atom, molecule, organism).npx @slipstream-ui/cli@latest list --package ai --tier molecule
npx @slipstream-ui/cli@latest diff [options]
Read-only comparison of your installed components against the registry. Reports version drift, modified files, missing files, and local-only files. Exits non-zero when drift is found, so it can gate CI.
--json Machine-readable output for scripting and CI.npx @slipstream-ui/cli@latest diff --json
| File | Command | Purpose |
|---|---|---|
| slipstream.config.json | init | Project config: component directory, style, package list, detected framework. |
| components/slipstream/<id>/ | add | Component source files you now own and can edit. |
| components/slipstream/manifests/<id>.manifest.json | add | The COMPONENT_MANIFEST — prop schema, anti-patterns, a11y rules. |
| Global stylesheet (CSS variables) | init | Theme variables appended to globals.css / index.css. An existing brand theme is extended with only the missing tokens. |
diff exits with a non-zero code when installed components differ from the registry, so a single step fails the build on drift without mutating your project.
# .github/workflows/ci.yml- name: Check Slipstream component driftrun: npx @slipstream-ui/cli@latest diff
"No package.json found."
Run the command from your project root, not a subdirectory.
"Slipstream is already initialized."
Config already exists. Pass --defaults to refresh it, or delete slipstream.config.json first.
"Unknown component: xyz."
Run npx @slipstream-ui/cli@latest list to see valid component ids.
"destination already exists."
The component is already copied. Add --overwrite to replace it, or npx @slipstream-ui/cli@latest diff to see what changed.
Theme variables were not injected.
For Tailwind 3, init extends an existing CSS-variable theme with only the tokens it is missing. If Tailwind is not detected, import the prebuilt stylesheets - see Theming.
Copied component cannot find its imports.
add copies the component's sibling dependencies and the shared utils into components/slipstream. Install any third-party packages the command lists (for example @radix-ui/react-slot).
Prefer source copies over packages? See Installation for the shadcn-compatible registry path, or Theming for createTheme() setup.