Base UI Migrator

Automated workflow that converts bespoke React UI primitives and other component libraries to Base UI (@base-ui/react).

Base UI is the unstyled successor to Radix UI, maintained by the Material UI team and Radix authors. It exposes the same composition model (Root + parts) but with a single canonical API, modern data attributes for state styling, and built-in transitions. This skill knows the full catalog (37 components, snapshotted) and how to map common bespoke patterns to it.

When to Apply

Use this skill when:

• The user explicitly asks to migrate to Base UI, or to a specific Base UI component.
• You spot a React file with bespoke overlays — manual modals, dropdown menus built from useState + click-outside hooks, floating UI compositions — that have a Base UI equivalent.
• The codebase uses Radix UI, Headless UI, Reach UI, or react-aria components — these are 1:1 mappable to Base UI.
• The user wants to consolidate a fragmented set of UI primitives behind one library.
• The user wants to scan a directory for migration opportunities.

Do NOT trigger when:

• The user is starting a fresh project and asks for a UI library recommendation (suggest they install Base UI directly, no migration needed).
• The user is migrating away from Base UI (out of scope).