What problem does it solve?
Helps frontend developers and designers manage, add, update, and verify shadcn/ui components across projects and registries while preserving project conventions, aliases, and Tailwind theming to avoid broken imports, inconsistent styling, and accessibility regressions.
Core Features & Use Cases
- Project-aware CLI guidance: Uses project context (package manager, aliases, base, style, tailwind config) to run the correct shadcn CLI commands and choose safe workflows.
- Component lifecycle: Search registries, preview add operations with dry-run and diff, install or update components, and perform smart merges that preserve local changes.
- Rules & enforcement: Provides best-practice rules for styling, forms, composition, icons, and base vs radix differences to ensure accessibility and consistency.
- Preset and registry management: Apply or switch presets with overwrite/merge/skip options, configure custom registries, and fix third-party imports to match project aliases.
- MCP tooling: Integrates MCP endpoints for registry listing, viewing item contents, audit checklists, and generating install commands for automation or AI-assisted workflows.
- Use case examples: Add a reusable dialog component from a community registry with --dry-run to preview diffs; migrate a project's visual style by applying a preset and smart-merging customized components.
Quick Start
Ask the assistant to inspect the project with npx shadcn@latest info, then run an add command in dry-run mode to preview changes before installing.