Migrate docs from Mintlify to fumadocs

.gitignore

@@ -1,9 +1,27 @@
-*/.DS_Store
+# deps
+/node_modules
+
+# generated content
+.source
+
+# test & build
+/coverage
+/.next/
+/out/
+/build
+*.tsbuildinfo
+
+# misc
 .DS_Store
-.env
+*.pem
+/.pnp
+.pnp.js
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
 
-node_modules/
-venv
-__pycache__/**
-test.py
-./kernel/**
+# others
+.env
+.env*.local
+.vercel
+next-env.d.ts

AGENTS.md

@@ -17,8 +17,8 @@
 
 ## Cursor Cloud specific instructions
 
-This is a Mintlify documentation site (no `package.json`). The only service is the docs preview server.
+This is a fumadocs (Next.js) documentation site. Content lives in `content/docs/` as MDX.
 
-- **Run the docs site:** `mintlify dev` (serves on `http://localhost:3000` by default; auto-increments if the port is busy)
-- **Lint/build:** Mintlify handles rendering; there's no separate lint or build step. Validate by running `mintlify dev` and checking pages load.
-- **Config:** `docs.json` is the main Mintlify config (navigation, theme, OpenAPI spec URL, redirects).
+- **Run the docs site:** `bun dev` (serves on `http://localhost:3000`)
+- **Lint/build:** `bun run build` compiles every page; `bun run lint` runs Biome. Validate changes with a build.
+- **Config:** `docs.json` remains the navigation source of truth (tabs/groups/redirects); `lib/tree.ts` converts it to the sidebar at build time. Mintlify components (`<Info>`, `<CodeGroup>`, `<Steps>`, ...) still work — they're aliased in `components/mdx.tsx`.

README.md

@@ -26,7 +26,8 @@ When you add Go examples:
 To run the docs locally, you can use the following command:
 
 ```bash
-mintlify dev
+bun install
+bun dev
 ```
 
 ## Contributing

app/(docs)/[[...slug]]/page.tsx

@@ -0,0 +1,88 @@
+import {
+ DocsBody,
+ DocsDescription,
+ DocsPage,
+ DocsTitle,
+ MarkdownCopyButton,
+} from "fumadocs-ui/layouts/notebook/page";
+import { createRelativeLink } from "fumadocs-ui/mdx";
+import type { Metadata } from "next";
+import { notFound, redirect } from "next/navigation";
+import { getMDXComponents } from "@/components/mdx";
+import { OpenInDropdown } from "@/components/page-actions";
+import { SocialFooter } from "@/components/social-footer";
+import { siteOpenGraph } from "@/lib/shared";
+import { getPageImage, getPageMarkdownUrl, source } from "@/lib/source";
+import { getEyebrow } from "@/lib/tree";
+
+export default async function Page(props: PageProps<"/[[...slug]]">) {
+ const params = await props.params;
+ const page = source.getPage(params.slug);
+ if (!page) notFound();
+ // Mintlify url: frontmatter marks a page as an external sidebar link
+ if (page.data.url) redirect(page.data.url);
+
+ const MDX = page.data.body;
+ const markdownUrl = getPageMarkdownUrl(page).url;
+ const eyebrow = getEyebrow(params.slug ?? []);
+ // Mintlify's mode: wide widens the content column and drops the TOC
+ const full = page.data.full || page.data.mode === "wide";
+
+ return (
+ <DocsPage
+ toc={page.data.toc}
+ full={full}
+ breadcrumb={{ enabled: false }}
+ footer={{ children: <SocialFooter /> }}
+ >
+ {eyebrow ? (
+ <span className="-mb-4 text-sm font-semibold text-fd-primary">
+ {eyebrow}
+ </span>
+ ) : null}
+ <DocsTitle className="text-3xl tracking-tight sm:text-4xl">
+ {page.data.title}
+ </DocsTitle>
+ <DocsDescription className="mb-0">
+ {page.data.description}
+ </DocsDescription>
+ <div className="flex flex-row gap-2 items-center border-b pb-6">
+ <MarkdownCopyButton markdownUrl={markdownUrl}>
+ Copy page
+ </MarkdownCopyButton>
+ <OpenInDropdown />
+ </div>
+ <DocsBody>
+ <MDX
+ components={getMDXComponents({
+ // this allows you to link to other pages with relative file paths
+ a: createRelativeLink(source, page),
+ })}
+ />
+ </DocsBody>
+ </DocsPage>
+ );
+}
+
+export async function generateStaticParams() {
+ return source.generateParams();
+}
+
+export async function generateMetadata(
+ props: PageProps<"/[[...slug]]">,
+): Promise<Metadata> {
+ const params = await props.params;
+ const page = source.getPage(params.slug);
+ if (!page) notFound();
+
+ return {
+ title: page.data.title,
+ description: page.data.description,
+ alternates: { canonical: page.url },
+ openGraph: {
+ ...siteOpenGraph,
+ url: page.url,
+ images: getPageImage(page).url,
+ },
+ };
+}

app/(docs)/api-reference/[[...slug]]/page.tsx

@@ -0,0 +1,59 @@
+import {
+ DocsBody,
+ DocsDescription,
+ DocsPage,
+ DocsTitle,
+} from "fumadocs-ui/layouts/notebook/page";
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import { OpenAPIPage } from "@/components/api-page";
+import { SocialFooter } from "@/components/social-footer";
+import { siteOpenGraph } from "@/lib/shared";
+import { apiSource, getApiPageImage } from "@/lib/source";
+
+export default async function Page(
+ props: PageProps<"/api-reference/[[...slug]]">,
+) {
+ const params = await props.params;
+ const page = apiSource.getPage(params.slug);
+ if (!page) notFound();
+
+ return (
+ <DocsPage toc={page.data.toc} footer={{ children: <SocialFooter /> }}>
+ <DocsTitle className="text-3xl tracking-tight sm:text-4xl">
+ {page.data.title}
+ </DocsTitle>
+ {page.data.description ? (
+ <DocsDescription className="mb-0">
+ {page.data.description}
+ </DocsDescription>
+ ) : null}
+ <DocsBody>
+ <OpenAPIPage {...page.data.getOpenAPIPageProps()} />
+ </DocsBody>
+ </DocsPage>
+ );
+}
+
+export function generateStaticParams() {
+ return apiSource.generateParams();
+}
+
+export async function generateMetadata(
+ props: PageProps<"/api-reference/[[...slug]]">,
+): Promise<Metadata> {
+ const params = await props.params;
+ const page = apiSource.getPage(params.slug);
+ if (!page) notFound();
+
+ return {
+ title: page.data.title,
+ description: page.data.description,
+ alternates: { canonical: page.url },
+ openGraph: {
+ ...siteOpenGraph,
+ url: page.url,
+ images: getApiPageImage(page).url,
+ },
+ };
+}

app/(docs)/layout.tsx

@@ -0,0 +1,35 @@
+import { buttonVariants } from "fumadocs-ui/components/ui/button";
+import { DocsLayout } from "fumadocs-ui/layouts/notebook";
+import { MessageCircleIcon } from "lucide-react";
+import {
+ AISearch,
+ AISearchPanel,
+ AISearchTrigger,
+} from "@/components/ai/search";
+import { cn } from "@/lib/cn";
+import { baseOptions } from "@/lib/layout.shared";
+import { buildTree } from "@/lib/tree";
+
+export default function Layout({ children }: LayoutProps<"/">) {
+ return (
+ <DocsLayout tree={buildTree()} tabMode="navbar" {...baseOptions()}>
+ <AISearch>
+ <AISearchPanel />
+ <AISearchTrigger
+ position="float"
+ className={cn(
+ buttonVariants({
+ variant: "secondary",
+ className: "text-fd-muted-foreground rounded-2xl",
+ }),
+ )}
+ >
+ <MessageCircleIcon className="size-4.5" />
+ Ask AI
+ </AISearchTrigger>
+ </AISearch>
+
+ {children}
+ </DocsLayout>
+ );
+}