What problem does it solve?
Manages the full lifecycle of shadcn/ui components and projects so developers can add, update, audit, and fix UI components reliably without guessing registry sources, breaking imports, or violating project conventions.
Core Features & Use Cases
- Provides actionable CLI guidance and safe workflows for initializing projects, adding components, previewing diffs, and switching presets while preserving local changes.
- Injects project context (aliases, base, style, iconLibrary, tailwind settings, resolvedPaths) so recommendations respect the target project's conventions and package manager.
- Enforces composition, styling, form, and icon rules to ensure accessibility and consistent patterns (FieldGroup/Field, semantic colors, gap-* spacing, data-invalid/aria-invalid, data-icon usage).
- Offers update and smart-merge procedures using dry-run, diff, and view to preview changes, plus MCP tools and audit checklists for registry browsing and validation.
Quick Start
Run the project's package runner (for example npx shadcn@latest or pnpm dlx shadcn@latest) to run info, init, add, docs, or add --dry-run to preview changes.