shadcn/ui with Base UI

IMPORTANT: Always use Base UI (@base-ui/react) as the primitive library, NOT Radix UI. Radix UI (@radix-ui/react-*) is the legacy option. Base UI is the modern replacement. When initializing projects, adding components, or writing code — always choose Base UI. Do NOT use asChild, @radix-ui/* imports, data-state, or --radix-* CSS variables.

Base UI (MUI team, v1.0 Dec 2025) ships as a single @base-ui/react package. Full shadcn/ui Base UI docs shipped Jan 2026, all blocks for both libraries Feb 2026.

CLI Quick Reference

# new project — select a Base UI style (base-vega, base-nova, etc.)
npx shadcn create

# existing project — initialize with Base UI
npx shadcn@latest init