Skip to content

docs: migrate webdocs from Mintlify to fumadocs content format#203

Merged
aroff merged 1 commit into
mainfrom
feat/fumadocs-migration
Jul 10, 2026
Merged

docs: migrate webdocs from Mintlify to fumadocs content format#203
aroff merged 1 commit into
mainfrom
feat/fumadocs-migration

Conversation

@aroff

@aroff aroff commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Migrate all 49 MDX/MD files in webdocs/ from Mintlify components to fumadocs MDX format
  • Replace central mint.json config with 13 per-folder meta.json navigation files
  • Convert all Mintlify-specific components to fumadocs equivalents (Callouts, Cards, Accordions, Steps, Tabs, ParamField)
  • Add MIGRATION.md documenting the conversion and host-app integration steps

Component mappings

Mintlify Fumadocs
<Note>/<Info>/<Warning>/<Tip>/<Check> <Callout type="...">
<CardGroup>/<Card icon="..."> <Cards>/<Card>
<AccordionGroup>/<Accordion> <Accordions>/<Accordion id="...">
<Steps>/<Step title="X"> ### 1. X numbered headings
<Tabs>/<Tab title="X"> <Tabs items={[...]}>/<Tab value="X">
<ParamField> #### \field` (type, required)` headings
<Frame> removed (content kept)

Validation

All 15 key pages verified with Playwright headless browser testing:

  • 15/15 pages return HTTP 200 with correct h1 titles
  • Sidebar navigation (290px aside with all groups/links) rendering correctly
  • Tabs, Cards, Callouts, Accordions, and Steps components all rendering
  • All screenshots unique (no duplicate/blank captures)
  • CSS theme loading properly (84KB compiled stylesheet)

This migration covers content only — no hosting application is included. The converted content drops into any fumadocs MDX app by pointing defineDocs({ dir: 'content/docs' }) at this directory.

Convert all MDX content from Mintlify components to fumadocs equivalents:
- Callouts: <Note>/<Info>/<Warning>/<Tip>/<Check> -> <Callout type="...">
- Cards: <CardGroup>/<Card icon="..."> -> <Cards>/<Card>
- Accordions: <AccordionGroup>/<Accordion> -> <Accordions>/<Accordion id="...">
- Steps: <Steps>/<Step title="..."> -> numbered headings (### 1. Title)
- Tabs: <Tabs>/<Tab title="..."> -> <Tabs items={[...]}>/<Tab value="...">
- ParamField -> markdown headings with type annotations
- Escape CLI placeholders as HTML entities

Replace central mint.json with per-folder meta.json navigation files.
Rename TROUBLESHOOTING.md to troubleshooting.mdx for slug consistency.
Add MIGRATION.md documenting the conversion and host-app integration steps.
@aroff aroff merged commit e2f5b73 into main Jul 10, 2026
10 checks passed
@aroff aroff deleted the feat/fumadocs-migration branch July 10, 2026 16:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant