---

name: setup-shadcn description: Set up Shadcn/UI based on Base UI headless components

Set up Shadcn/UI with Base UI

This skill sets up Shadcn/UI using Base UI headless components instead of the default Radix UI primitives.

Why Base UI?

Base UI (from MUI) provides unstyled, accessible React components similar to Radix UI. This approach gives you Shadcn's styling conventions while using Base UI's headless primitives.

Setup Steps

1. Initialize Shadcn/UI

Run the default init command to create basic configuration files:

Copypnpx shadcn@latest init

Let the user to choose preferred base color (neutral, gray, zinc, stone, slate)

2. Install Base UI

Install the Base UI package. Ensure to use @base-ui/react (not @base-ui-components/react)

Copypnpm add @base-ui/react

3. Remove Radix UI Dependencies

After initialization, remove any Radix UI packages that were installed:

Copypnpm remove @radix-ui/react-*

Or selectively remove only the primitives you'll replace with Base UI equivalents.

4. Update components.json

Modify components.json to reflect the Base UI approach:

Copy{
  "$schema": "https://ui.shadcn.com/schema.json",
  "style": "base-{vega|nova|maia|lyra|mira}",
  // ...
  "iconLibrary": "lucide"
}

Ask the user which style to pick from the available Base UI styles.

Notes

• Not all Radix primitives have direct Base UI equivalents - check Base UI documentation for available components
• Base UI components may have slightly different APIs; adjust component implementations accordingly
• Refer to Base UI documentation for component usage details