tomevault-io Radix UI vs Base UI Package Sync
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.
Package identity
| 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' |
What to keep in sync
- Layouts:
layouts/docs,layouts/flux,layouts/home,layouts/notebook,layouts/shared— structure and props should match; only primitive usage differs. - Components: Same public API and behavior for components under
components/(e.g. toc, steps, sidebar/page-tree, dialog/search behavior). UI primitives incomponents/ui/differ by design. - Provider:
provider/base.tsx— same props; onlyDirectionProviderand search/dialog primitives differ. - Contexts, utils, i18n, mdx, og: Should stay identical or nearly identical.
- package.json: Same
exportsshape and version;dependenciesdiffer (Radix vs Base UI).
Source: fuma-nama/fumadocs — distributed by TomeVault.