What problem does it solve?
Manages the lifecycle of shadcn/ui components in frontend projects so teams can add, update, and audit UI components without breaking imports, styles, or local customizations. It prevents unsafe manual file edits by directing all registry and preset operations through the shadcn CLI and enforces composition, styling, and accessibility rules for consistent UI integration.
Core Features & Use Cases
- Safe component installation & previews: Use the CLI with --dry-run, --diff, and --view to preview changes, diffs, and resolved file paths before writing files.
- Smart updates & merges: Intelligent workflows for updating upstream components while preserving local modifications using per-file diffs and guided merge decisions.
- Project-aware guidance: Reads project context (package manager, aliases, tailwind version, iconLibrary, base) to fix imports, register theme variables correctly, and select the correct primitives (base vs radix).
- Auditing & rules enforcement: Built-in checklists and rule sets for styling, composition, forms, icons, and accessibility to catch common integration mistakes.
- Registry & preset management: Search, view, and install from custom registries, and safely switch or merge presets (reinstall, merge, skip) per user choice.
Quick Start
Preview component additions and diffs with the project's package runner by running a dry-run add command such as npx shadcn@latest add button --dry-run to inspect files and CSS changes before applying them.