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,84 @@
+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 { 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,
+    openGraph: {
+      images: getPageImage(page).url,
+    },
+  };
+}

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

@@ -0,0 +1,49 @@
+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 { apiSource } 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 };
+}

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>
+  );
+}