// Keep packages/radix-ui (fumadocs-ui) and packages/base-ui in sync. Use when editing either package, adding features, or fixing bugs so both UI variants stay consistent.
| name | radix-base-ui-sync |
| description | Keep packages/radix-ui (fumadocs-ui) and packages/base-ui in sync. Use when editing either package, adding features, or fixing bugs so both UI variants stay consistent. |
packages/radix-ui (fumadocs-ui) and packages/base-ui (@fumadocs/base-ui) are two variants of Fumadocs UI. They share the same layout structure, components, and public API; only the underlying primitives differ. When changing one package, consider the other.
| radix-ui | base-ui | |
|---|---|---|
| Package name | fumadocs-ui | @fumadocs/base-ui |
| Primitives | @radix-ui/* | @base-ui/react |
| Config key | uiLibrary: 'radix-ui' | uiLibrary: 'base-ui' |
layouts/docs, layouts/flux, layouts/home, layouts/notebook, layouts/shared — structure and props should match; only primitive usage differs.components/ (e.g. toc, steps, sidebar/page-tree, dialog/search behavior). UI primitives in components/ui/ differ by design.provider/base.tsx — same props; only DirectionProvider and search/dialog primitives differ.exports shape and version; dependencies differ (Radix vs Base UI).