radix-to-baseui-migration
Installation
SKILL.md
Radix to Base UI Migration (shadcn)
Execute migration in four passes. Keep each pass small and compilable.
1) Remove Radix package surface and switch imports
- Remove Radix primitive packages from dependencies.
- Add Base UI package(s) used by the project.
- Replace Radix imports with Base UI imports component-by-component.
- Keep component names stable during this pass (use aliases if needed) to reduce diff size.
Use references/checklist.md for pass order and validation gates.
2) Replace asChild composition with Base UI render composition
- Find trigger/content compositions that relied on
asChild. - Replace
asChildusage with Base UI render-based composition. - Preserve semantic HTML and avoid nested interactive elements.
- Re-test keyboard and focus behavior for each migrated trigger.