Conversation
Assisted-by: Claude Opus 5.5
Assisted-by: Claude Opus 5.5
Pure renames, no content changes, so rename detection keeps blame and `git log --follow` intact across the migration. Nextra's sibling-file folder indexes (room.mdx next to room/) become room/index.mdx. The build stays broken until the Fumadocs scaffold lands. Assisted-by: Claude Opus 5.5
Mechanical rewrite by a one-off codemod: _meta files become meta.json, tabs get explicit values instead of positions, filename= becomes title=, MovedAnchors moves to frontmatter, and body H1s go because Fumadocs renders the frontmatter title. Heading slugs were checked unchanged per page. Every language switcher now joins one persisted group, so a reader's pick on /sdk carries to /state/callbacks and the netcode pages. The pages/404.mdx map becomes public/_redirects: prefix rules replace includes() matching, which also ends the /tutorial -> /learn/tutorial redirect loop. Three headings lose their inline link: Fumadocs wraps heading text in an anchor, and a nested <a> breaks hydration. Assisted-by: Claude Opus 5.5
Next 16 app router, fumadocs-mdx, Notebook layout, static export as before. Pages import nothing: every component, octicons included, is registered in components/mdx.tsx. Images keep their public URLs rather than becoming bundler imports: Turbopack rejects the uppercase .PNG files in public/tutorial, and renaming them would break their URLs. The search index skips Orama's sort indexes: results rank by relevance only, and the sort data was a third of the 6.7 MB file. Assisted-by: Claude Opus 5.5
The scripts now run Fumadocs' own loader() over content/docs, so routes, sidebar order and labels come from the code that builds the site rather than a regex evaluation of _meta.tsx JSX. check-links takes heading ids from Fumadocs' remarkHeading. That fixes underscores being stripped from four slugs, and folder routes with no page no longer pass as link targets. It also lints public/_redirects for dead, shadowed and looping rules, which the includes() map could not express. Markdown twins are rendered by the /md route through lib/llms-markdown.ts instead of a hand-written MDX parser. Unknown components still fail the build. Sitemap lastmod follows renames and skips the migration commits, so moving every page doesn't reset every date. Assisted-by: Claude Opus 5.5
Nextra's "Edit this page" link in the sidebar is gone; Fumadocs puts "Edit on GitHub" under the table of contents. Assisted-by: Claude Opus 5.5
Assisted-by: Claude Opus 5.5
Pure renames: route-group folders are not part of the URL, so every page keeps its route. Sidebar tabs follow in the next commit. Assisted-by: Claude Opus 5.5
One sidebar of ~26 top-level entries becomes four navbar tabs, each with its own sidebar. Every URL is unchanged: the tabs are route-group root folders, and route groups don't take part in the URL. /sdk stays in Docs to keep the server → room → state → sdk build loop in one place; the Client SDKs tab links to it and opens on its first engine page instead. llms.txt sections follow the tabs. Assisted-by: Claude Opus 5.5
Mechanical rewrite by a one-off codemod, verified per file: heading
slugs unchanged, and every highlighted code block rendered through
Fumadocs' own Shiki transformers to confirm the same lines highlight
and the code text is identical.
- Tabs declare `items`; the SDK language tabs are
`<Tabs groupId="lang" persist>` instead of a LangTabs wrapper
- Steps wrap each step in `<Step>`
- Callouts use `warn`, details become Accordions
- `{1,3-5}` fence meta becomes `// [!code highlight:N]` lines
- sidebar and Card icons are lucide; decorative inline icons are gone
- the scenario cards are Cards, the example tables are GFM tables
Assisted-by: Claude Opus 5.5
The custom ScenarioCard, ClientList, DemoCard and PremiumDemos components give way to Cards, markdown tables and a shared partial pulled in with <include>. The Tabs, Steps, image and hero wrappers are gone too. What's left is Fumadocs, plus Mermaid (Fumadocs' documented recipe) and the engine logos, which lucide doesn't carry. Tab keeps inactive panels mounted: without it only the default language's code reached the static HTML, so crawlers never saw the C#, Lua, Haxe, GDScript or Dart examples. Remote image sizes are fetched at build, as Fumadocs does by default, which retires the plain-<img> fallback. Assisted-by: Claude Opus 5.5
Member
Author
|
Closing without merging: keeping the Nextra site. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Moves docs.colyseus.io from Nextra 3 / Next 13 to Fumadocs 16 / Next 16 (still a static export on Netlify), and splits the one ~26-entry sidebar into four navbar tabs: Docs · Client SDKs · Learn · Deploy & Cloud.
Every URL and anchor is unchanged. The tabs are route-group folders, which don't take part in the URL. A build-to-build comparison against master: same 141 routes, every heading id and every code block identical.
Readers
public/_redirects, instead of a 404 page plus a JS redirect. This also ends the/tutorial→/learn/tutorialredirect loop./sdkcarries to/state/callbacksand the netcode pages..mdtwins andllms-full.txtare kept.<title>is unchanged.Authors
content/docs/, sidebar order inmeta.json, written in Fumadocs' own conventions: built-inTabs(items+groupId),Steps/Step,Cards,Accordion,Callout type="warn", lucide icons, and// [!code highlight]notation. The Nextra-era custom components are gone; only Mermaid and the engine logos remain beside Fumadocs.pnpm check-linksnow takes heading ids from Fumadocs itself. It also lints_redirects(dead, shadowed and looping rules) andmovedAnchorsfrontmatter, which replaces<MovedAnchors>.pnpm build: 1m45s → 1m07s.move-pageanddocs-reviewskills updated.Merging
Use a merge commit, not a squash. Two commits are pure renames so
git log --followand blame survive;.git-blame-ignore-revslists them.Also carries two content commits made on master before branching: the Cloud Read API page and a StateView example fix.
Before marking ready
_redirectsrule answers 301 → 200/room/built-inkeeps its#built-in-roomsfragment through the 301.mdtwins astext/markdown, unknown paths a real 404 (checked via response headers, not the build log)🤖 Generated with Claude Code