radix-base-ui-sync

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. Use when this capability is needed.
metadata	{"author":"fuma-nama"}

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 in components/ui/ differ by design.
• Provider: provider/base.tsx — same props; only DirectionProvider and search/dialog primitives differ.
• Contexts, utils, i18n, mdx, og: Should stay identical or nearly identical.
• package.json: Same exports shape and version; dependencies differ (Radix vs Base UI).

---

Source: fuma-nama/fumadocs — distributed by TomeVault.