---

name: shadcn description: Add and manage shadcn/ui components via CLI. Use when installing new UI components, building forms with validation, creating modals/dialogs/sheets, adding navigation menus, setting up data tables or charts, or updating existing shadcn components.

shadcn/ui CLI

Quickly add pre-built, customizable React components based on Radix UI and Tailwind CSS.

Quick Reference

Common Component Groups

Forms: button, input, label, select, checkbox, radio-group, switch, textarea, form

Layout: card, separator, tabs, accordion, collapsible, resizable

Feedback: alert, alert-dialog, dialog, drawer, sheet, toast, sonner, tooltip, popover

Navigation: dropdown-menu, menubar, navigation-menu, breadcrumb, pagination, command

Data Display: table, data-table, avatar, badge, calendar, carousel, chart

Usage Patterns

Add a single component

Copynpx shadcn@latest add button

Add multiple related components

Copynpx shadcn@latest add form input label select

Skip confirmation prompts

Copynpx shadcn@latest add -y dialog

Overwrite existing component (after shadcn update)

Copynpx shadcn@latest add -o button

Preview before installing

Copynpx shadcn@latest view chart

Custom install path

Copynpx shadcn@latest add button -p src/components/ui

Key Flags

Project Notes

• Components install to src/ui/ in this project (configured in components.json)
• Uses @/ path alias for imports
• Tailwind CSS + CVA (class-variance-authority) for variants
• All components are fully customizable after installation

Troubleshooting

Component already exists: Use -o flag to overwrite

Copynpx shadcn@latest add -o button

Missing dependencies: The CLI auto-installs peer deps, but if issues occur:

Copynpm install @radix-ui/react-<primitive> class-variance-authority

Path issues: Check components.json for configured paths