Skip to content

docs: migrate website from Docusaurus to Fumadocs#10

Merged
siracusa5 merged 5 commits intomainfrom
docs/fumadocs-migration
Mar 12, 2026
Merged

docs: migrate website from Docusaurus to Fumadocs#10
siracusa5 merged 5 commits intomainfrom
docs/fumadocs-migration

Conversation

@siracusa5
Copy link
Collaborator

Summary

  • Replace Docusaurus 3.7.0 with Fumadocs (fumadocs-core 15.x / fumadocs-mdx 11.x / Next.js 15)
  • All 27 docs migrated with Fumadocs-compatible frontmatter, sidebar config (meta.json), and MDX conversions
  • Custom landing page with Supermemory-inspired design: hero cards, feature grid, 7-plugin showcase
  • Neutral dark theme with purple accent-only (custom CSS variables, not built-in purple preset)
  • Architecture SVGs converted from Docusaurus CSS vars to hardcoded dark-theme colors; new "Sharing Your Setup" diagram added
  • Version bridge in lib/source.ts for fumadocs-mdx/core files incompatibility
  • Blog posts and static assets preserved

Test plan

  • next build passes clean — 33 static pages generated
  • Visual review of landing page, docs pages, and sidebar navigation
  • Verify all 27 doc pages render correctly (especially 4 MDX files with Callout components)
  • Check architecture SVG diagrams render with correct dark-theme colors
  • Test mobile responsiveness of landing page
  • Verify blog posts are still accessible (may need Fumadocs blog integration later)

🤖 Generated with Claude Code

siracusa5 and others added 5 commits March 12, 2026 00:54
Domain migration: all links to the Harness Protocol website now point
to harnessprotocol.io (primary TLD) instead of .ai.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Replace the Docusaurus 3.7.0 documentation site with Fumadocs (Next.js).
All 27 docs migrated with Fumadocs-compatible frontmatter and sidebar config.

Key changes:
- Framework: Docusaurus → fumadocs-core 15.x / fumadocs-mdx 11.x / Next.js 15
- Theme: custom neutral dark with purple accent (not the built-in purple preset)
- Landing page: Supermemory-inspired design with hero cards, feature grid, plugin showcase
- Architecture SVGs: converted from Docusaurus CSS vars to hardcoded dark-theme colors
- New "Sharing Your Setup" diagram added to architecture page
- 4 files converted to .mdx for Callout components (orient, setup-guide, concept-mapping, architecture)
- Version bridge in lib/source.ts for fumadocs-mdx/core files incompatibility
- Blog posts and static assets preserved

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Remove dead Blog link from docs nav (no Fumadocs blog route yet)
- Remove duplicate writing-evals.md from guides/ (canonical copy in evals/)
- Add favicon via app/icon.svg (Next.js convention)
- Add packageManager field to enforce pnpm

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- validate.yml + deploy-docs.yml: npm → pnpm with pnpm/action-setup@v4
- deploy output dir: website/build (Docusaurus) → website/out (Next.js)
- next.config.mjs: add output: 'export' for Cloudflare Pages static deploy

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@siracusa5 siracusa5 merged commit 09fdbb0 into main Mar 12, 2026
2 checks passed
@siracusa5 siracusa5 deleted the docs/fumadocs-migration branch March 12, 2026 06:32
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