Radix Base UI Sync
Developmentradix-base-ui-syncRadix Base UI Sync is an Agent Skill for development published in the fuma-nama/fumadocs repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/fuma-nama/fumadocs/blob/HEAD/.cursor/skills/radix-base-ui-sync/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/radix-base-ui-sync, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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).