Skip to content

Migrate docs source to Fumadocs#4981

Open
felixfeng33 wants to merge 57 commits into
mainfrom
codex/fumadocs-migration
Open

Migrate docs source to Fumadocs#4981
felixfeng33 wants to merge 57 commits into
mainfrom
codex/fumadocs-migration

Conversation

@felixfeng33
Copy link
Copy Markdown
Collaborator

Summary

Migrate the docs app source pipeline from Contentlayer to Fumadocs MDX while preserving Plate's existing docs shell, registry-backed docs pages, raw markdown copy, and EN/CN route behavior.

What changed

  • Add Fumadocs source config, generated-source aliasing, and Next MDX integration for apps/www.
  • Replace Contentlayer route lookups with Fumadocs source access for English and Chinese docs routes.
  • Split registry metadata helpers from runtime component lookup so source generation stays server-safe.
  • Add explicit MDX client boundaries and compatibility fixes for package info, API lists, and accordions.
  • Remove Contentlayer config/dependencies and add a docs source parity check wired into www typecheck.

Verification

  • pnpm check
  • pnpm --filter www check:docs
  • pnpm --filter www exec next build
  • Browser smoke previously covered /docs, /docs/installation, /docs/components/editor, /docs/table, /docs/api/core, /docs/releases, /cn/docs/table, and /docs/examples/slate-to-html.

Note: local registry generation was not run because repo rules forbid build:registry outside CI.

@felixfeng33 felixfeng33 requested a review from a team May 23, 2026 05:10
@codesandbox
Copy link
Copy Markdown

codesandbox Bot commented May 23, 2026

Review or Edit in CodeSandbox

Open the branch in Web EditorVS CodeInsiders

Open Preview

@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented May 23, 2026

⚠️ No Changeset found

Latest commit: 7443889

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@dosubot dosubot Bot added size:XXL This PR changes 1000+ lines, ignoring generated files. build labels May 23, 2026
@dosubot dosubot Bot added the size:XS This PR changes 0-9 lines, ignoring generated files. label May 23, 2026
@dosubot dosubot Bot added size:XXL This PR changes 1000+ lines, ignoring generated files. and removed size:XS This PR changes 0-9 lines, ignoring generated files. size:XXL This PR changes 1000+ lines, ignoring generated files. labels May 23, 2026
felixfeng33 and others added 30 commits May 24, 2026 19:19
Use light and dark Shiki output for docs code blocks, align BlockViewer and command code surfaces with the shared code tokens, and document the rehype-pretty-code theme pitfall.
# Conflicts:
#	.agents/rules/docs-creator.mdc
#	.agents/skills/docs-creator/SKILL.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

build size:XXL This PR changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants