shadcn

Run npx shadcn@latest add followed by the component names, using your project's package runner such as pnpm dlx or bunx. Check installed components first with npx shadcn@latest info, and preview changes with --dry-run or --diff before writing files.

Use npx shadcn@latest search with an optional registry namespace like @shadcn or a GitHub owner/repo source, plus -q for a query and -t to filter by item type. Without arguments it searches every registry configured in components.json.

The base field in components.json determines the primitive library, which changes component APIs. Radix uses asChild for composition while base uses render, and components like Select, ToggleGroup, Slider, and Accordion have different props between the two.

Run npx shadcn@latest add <component> --dry-run to see affected files, then --diff <file> to compare upstream changes against your local version. Merge updates per file, preserving local modifications, and never use --overwrite without explicit approval.

Yes, use npx shadcn@latest apply <code> in a project with components.json to overwrite preset-driven config, fonts, and CSS variables. Use --only theme,font for partial updates, or init --preset <code> --force --no-reinstall to keep existing components.

The styling rules require flex with gap-* instead of space-x-*/space-y-* and semantic tokens like bg-primary instead of raw colors like bg-blue-500. This keeps components consistent with the theme's CSS variables and dark mode behavior.