shadcn

Run npx shadcn@latest add followed by component names, registry-prefixed names like @magicui/shimmer-button, or GitHub addresses like owner/repo/item. Use --dry-run to preview changes and --diff to compare against existing files before writing.

Run npx shadcn@latest add <component> --dry-run to see affected files, then --diff <file> to inspect upstream changes. Merge manually where you have local edits, and never use --overwrite without explicit approval.

The base field in components.json determines the primitive library and 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.

Use npx shadcn@latest apply <code> to overwrite an existing project's preset, or init --preset <code> --force --no-reinstall to update only config and CSS. Inspect codes with preset decode and never decode preset strings manually.

FieldGroup and Field provide consistent layout, labeling, and validation wiring in shadcn/ui. Validation requires data-invalid on the Field and aria-invalid on the control, which raw div layouts with space-y-* do not provide.

Yes, the CLI supports namespaced registries configured in components.json and public GitHub registries via owner/repo addresses. After adding third-party items, verify imports match your project's aliases and icon library.