Migrate documentation site from custom @objectdocs/cli to Fumadocs

[Copilot]

Replace the custom @objectdocs/cli documentation tooling with Fumadocs, a modern Next.js-based documentation framework with better performance and maintainability.

Changes

Core Infrastructure

• Next.js 16 + App Router: Full static site generation for 136 documentation pages
• Fumadocs MDX: Auto-compilation from content/docs/ with type-safe collection handling
• Tailwind CSS v4: New CSS architecture with @tailwindcss/postcss

Configuration

// source.config.ts - Collection definition
export const docs = defineDocs({
  dir: 'content/docs',
}) as any; // Workaround for pnpm zod@4 type portability

// app/source.ts - Loader setup
import { docs } from 'fumadocs-mdx:collections/server';
export const source = loader({
  baseUrl: '/docs',
  source: (docs as any).toFumadocsSource(),
});

UI Components

• Collapsible sidebar with auto-generated navigation from meta.json files
• Search (⌘K), theme toggle, GitHub integration
• MDX components (Callout, Card, Cards) rendered via fumadocs-ui/mdx

Build Output

Route (app)
├ ○ /
└ ● /docs/[[...slug]] (136 pages)
  ├ /docs
  ├ /docs/concepts/*
  ├ /docs/references/*
  └ /docs/specifications/*

Type Compatibility

TypeScript path alias for virtual module imports:

{
  "paths": {
    "fumadocs-mdx:collections/*": ["./.source/*"]
  }
}

Screenshot

Scripts

pnpm docs:dev    # next dev
pnpm docs:build  # next build
pnpm docs:start  # next start

All existing MDX content preserved. The .source/ directory (auto-generated by Fumadocs) is gitignored.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• fonts.googleapis.com
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/spec/spec/node_modules/.bin/../next/dist/bin/next build (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

帮我使用fumadocs搭建此文档站点

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
spec	Ready	Preview, Comment	Jan 18, 2026 5:43pm