create-fumadocs-app 16.0.4 → 16.0.6

package/README.md

@@ -1,6 +1,6 @@
 # Create Fumadocs App
 
-A CLI tool to create new Next.js documentation sites with Fumadocs.
+A CLI tool to create new documentation sites with Fumadocs.
 
 ```bash
 npx create-fumadocs-app

package/dist/bin.js

@@ -3,11 +3,11 @@ import {
   create,
   getPackageManager,
   managers
-} from "./chunk-UXPTMGXV.js";
+} from "./chunk-PGCMK5N3.js";
 import {
   isCI,
   templates
-} from "./chunk-ZWEHS3HT.js";
+} from "./chunk-QKIRNPKF.js";
 
 // src/bin.ts
 import fs from "fs/promises";

package/dist/{chunk-UXPTMGXV.js → chunk-PGCMK5N3.js}

@@ -4,7 +4,7 @@ import {
   sourceDir,
   templates,
   tryGitInit
-} from "./chunk-ZWEHS3HT.js";
+} from "./chunk-QKIRNPKF.js";
 
 // src/index.ts
 import path from "path";

package/dist/{chunk-ZWEHS3HT.js → chunk-QKIRNPKF.js}

@@ -91,49 +91,20 @@ function pick(obj, keys) {
 // src/constants.ts
 import { fileURLToPath } from "url";
 
-// src/versions.js
-var versions = { "fumadocs-core": "16.0.3", "fumadocs-ui": "16.0.3", "fumadocs-mdx": "13.0.1", "@fumadocs/mdx-remote": "1.4.3", "@fumadocs/content-collections": "1.2.4" };
-
 // ../create-app-versions/package.json
 var package_default = {
-  name: "example-versions",
-  version: "0.0.0",
+  name: "create-fumadocs-versions",
+  version: "16.0.6",
   private: true,
   description: "Used to track dependency versions in create-fumadocs-app",
   dependencies: {
-    "@biomejs/biome": "^2.2.6",
-    "@content-collections/core": "^0.11.1",
-    "@content-collections/mdx": "^0.2.2",
-    "@content-collections/next": "^0.2.8",
+    "@biomejs/biome": "^2.3.1",
+    "@eslint/eslintrc": "^3.3.1",
     "@orama/core": "^1.2.13",
-    "@react-router/dev": "^7.9.4",
-    "@react-router/node": "^7.9.4",
-    "@react-router/serve": "^7.9.4",
-    "@tailwindcss/postcss": "^4.1.15",
-    "@tailwindcss/vite": "^4.1.15",
-    "@tanstack/react-router": "^1.133.21",
-    "@tanstack/react-start": "^1.133.21",
-    "@types/mdx": "^2.0.13",
-    "@types/node": "24.9.1",
-    "@types/react": "^19.2.2",
-    "@types/react-dom": "^19.2.2",
-    "@vitejs/plugin-react": "^5.0.4",
-    "gray-matter": "^4.0.3",
-    isbot: "^5.1.31",
-    "lucide-react": "^0.546.0",
-    next: "16.0.0",
-    postcss: "^8.5.6",
-    react: "^19.2.0",
-    "react-dom": "^19.2.0",
-    "react-router": "^7.9.4",
-    "react-router-devtools": "^5.1.3",
-    shiki: "^3.13.0",
-    tailwindcss: "^4.1.15",
-    tinyglobby: "^0.2.15",
-    typescript: "^5.9.3",
-    vinxi: "^0.5.8",
-    vite: "^7.1.11",
-    "vite-tsconfig-paths": "^5.1.4"
+    eslint: "^9.38.0",
+    "fumadocs-core": "workspace:*",
+    "fumadocs-mdx": "workspace:*",
+    "fumadocs-ui": "workspace:*"
   }
 };
 
@@ -172,12 +143,16 @@ var templates = [
     label: "Tanstack Start: Fumadocs MDX (not RSC)",
     appDir: "src",
     rootProviderPath: "routes/__root.tsx"
+  },
+  {
+    value: "tanstack-start-spa",
+    label: "Tanstack Start SPA: Fumadocs MDX (not RSC)",
+    hint: "SPA mode allows you to host the site statically, compatible with a CDN.",
+    appDir: "src",
+    rootProviderPath: "routes/__root.tsx"
   }
 ];
-var depVersions = {
-  ...versions,
-  ...package_default.dependencies
-};
+var depVersions = package_default.dependencies;
 
 export {
   writeFile,

package/dist/index.d.ts

@@ -2,7 +2,7 @@ type PackageManager = (typeof managers)[number];
 declare const managers: readonly ["npm", "yarn", "bun", "pnpm"];
 
 interface TemplateInfo {
-    value: '+next+fuma-docs-mdx' | 'waku' | 'react-router' | 'react-router-spa' | 'tanstack-start';
+    value: '+next+fuma-docs-mdx' | 'waku' | 'react-router' | 'react-router-spa' | 'tanstack-start' | 'tanstack-start-spa';
     label: string;
     appDir: string;
     /**

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   create
-} from "./chunk-UXPTMGXV.js";
-import "./chunk-ZWEHS3HT.js";
+} from "./chunk-PGCMK5N3.js";
+import "./chunk-QKIRNPKF.js";
 export {
   create
 };

package/dist/plugins/biome.js

@@ -8,7 +8,7 @@ import {
   depVersions,
   pick,
   writeFile
-} from "../chunk-ZWEHS3HT.js";
+} from "../chunk-QKIRNPKF.js";
 
 // src/plugins/biome.ts
 import path from "path";

package/dist/plugins/eslint.js

@@ -1,7 +1,8 @@
 import {
   depVersions,
+  pick,
   writeFile
-} from "../chunk-ZWEHS3HT.js";
+} from "../chunk-QKIRNPKF.js";
 
 // src/plugins/eslint.ts
 import path from "path";
@@ -43,9 +44,8 @@ function eslint() {
         },
         devDependencies: {
           ...packageJson.devDependencies,
-          eslint: "^9",
-          "eslint-config-next": depVersions.next,
-          "@eslint/eslintrc": "^3"
+          "eslint-config-next": packageJson.dependencies.next,
+          ...pick(depVersions, ["eslint", "@eslint/eslintrc"])
         }
       };
     },

package/dist/plugins/orama-cloud.js

@@ -4,7 +4,7 @@ import {
   pick,
   sourceDir,
   writeFile
-} from "../chunk-ZWEHS3HT.js";
+} from "../chunk-QKIRNPKF.js";
 
 // src/plugins/orama-cloud.ts
 import path2 from "path";
@@ -148,11 +148,12 @@ async function rootProvider({ appDir, template }, fn) {
           name: "search",
           initializer: "{{ SearchDialog }}"
         });
+        file.addImportDeclaration({
+          moduleSpecifier: specifier,
+          defaultImport: "SearchDialog"
+        });
+        break;
       }
-      file.addImportDeclaration({
-        moduleSpecifier: specifier,
-        defaultImport: "SearchDialog"
-      });
     }
   });
   await file.save();
@@ -286,6 +287,7 @@ See https://fumadocs.dev/docs/headless/search/orama-cloud for integrating Orama
       const filePath = {
         "+next+fuma-docs-mdx": ".next/server/app/static.json.body",
         "tanstack-start": ".output/public/static.json",
+        "tanstack-start-spa": "dist/client/static.json",
         "react-router": "build/client/static.json",
         "react-router-spa": "build/client/static.json",
         waku: "dist/public/static.json"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-fumadocs-app",
-  "version": "16.0.4",
+  "version": "16.0.6",
   "description": "Create a new documentation site with Fumadocs",
   "keywords": [
     "react",
@@ -32,7 +32,7 @@
   "dependencies": {
     "@clack/prompts": "^0.11.0",
     "@commander-js/extra-typings": "^14.0.0",
-    "commander": "^14.0.1",
+    "commander": "^14.0.2",
     "picocolors": "^1.1.1",
     "tinyexec": "^1.0.1",
     "ts-morph": "^27.0.2"
@@ -52,7 +52,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "pnpm run sync && tsup",
     "clean": "rimraf dist",
     "dev": "tsup --watch",
     "lint": "eslint .",

package/template/+next+fuma-docs-mdx/package.json

@@ -11,19 +11,19 @@
     "fumadocs-core": "workspace:*",
     "fumadocs-mdx": "workspace:*",
     "fumadocs-ui": "workspace:*",
-    "lucide-react": "^0.546.0",
+    "lucide-react": "^0.548.0",
     "next": "16.0.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0"
   },
   "devDependencies": {
-    "@tailwindcss/postcss": "^4.1.15",
+    "@tailwindcss/postcss": "^4.1.16",
     "@types/mdx": "^2.0.13",
     "@types/node": "^24.9.1",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
     "postcss": "^8.5.6",
-    "tailwindcss": "^4.1.15",
+    "tailwindcss": "^4.1.16",
     "typescript": "^5.9.3"
   }
 }

package/template/+next+fuma-docs-mdx/tsconfig.json

@@ -13,7 +13,7 @@
     "moduleResolution": "bundler",
     "resolveJsonModule": true,
     "isolatedModules": true,
-    "jsx": "preserve",
+    "jsx": "react-jsx",
     "incremental": true,
     "paths": {
       "@/*": ["./*"],
@@ -25,6 +25,12 @@
       }
     ]
   },
-  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts"
+  ],
   "exclude": ["node_modules"]
 }

package/template/react-router/package.json

@@ -21,15 +21,15 @@
   },
   "devDependencies": {
     "@react-router/dev": "^7.9.4",
-    "@tailwindcss/vite": "^4.1.15",
+    "@tailwindcss/vite": "^4.1.16",
     "@types/mdx": "^2.0.13",
     "@types/node": "^24.9.1",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
     "react-router-devtools": "^5.1.3",
-    "tailwindcss": "^4.1.15",
+    "tailwindcss": "^4.1.16",
     "typescript": "^5.9.3",
-    "vite": "^7.1.11",
+    "vite": "^7.1.12",
     "vite-tsconfig-paths": "^5.1.4"
   }
 }

package/template/react-router-spa/package.json

@@ -20,17 +20,17 @@
     "react-router": "^7.9.4"
   },
   "devDependencies": {
-    "serve": "^14.2.5",
     "@react-router/dev": "^7.9.4",
-    "@tailwindcss/vite": "^4.1.15",
+    "@tailwindcss/vite": "^4.1.16",
     "@types/mdx": "^2.0.13",
     "@types/node": "^24.9.1",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
     "react-router-devtools": "^5.1.3",
-    "tailwindcss": "^4.1.15",
+    "serve": "^14.2.5",
+    "tailwindcss": "^4.1.16",
     "typescript": "^5.9.3",
-    "vite": "^7.1.11",
+    "vite": "^7.1.12",
     "vite-tsconfig-paths": "^5.1.4"
   }
 }

package/template/tanstack-start/content/docs/index.mdx

@@ -4,7 +4,7 @@ description: Your favourite docs framework.
 icon: Rocket
 ---
 
-Hey there! Fumadocs is a docs framework built for Next.js, but do you know it also works on Tanstack Start?
+Hey there! Fumadocs is the docs framework that also works on Tanstack Start!
 
 ## Heading
 

package/template/tanstack-start/package.json

@@ -9,26 +9,26 @@
     "start": "node .output/server/index.mjs"
   },
   "dependencies": {
-    "@tanstack/react-router": "^1.133.21",
-    "@tanstack/react-router-devtools": "^1.133.21",
-    "@tanstack/react-start": "^1.133.21",
+    "@tanstack/react-router": "^1.133.32",
+    "@tanstack/react-router-devtools": "^1.133.34",
+    "@tanstack/react-start": "^1.133.34",
     "fumadocs-core": "workspace:*",
     "fumadocs-mdx": "workspace:*",
     "fumadocs-ui": "workspace:*",
-    "lucide-static": "^0.546.0",
+    "lucide-static": "^0.548.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "tailwind-merge": "^3.3.1",
-    "vite": "^7.1.11"
+    "vite": "^7.1.12"
   },
   "devDependencies": {
-    "@tailwindcss/vite": "^4.1.15",
+    "@tailwindcss/vite": "^4.1.16",
     "@types/mdx": "^2.0.13",
     "@types/node": "^24.9.1",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
-    "@vitejs/plugin-react": "^5.0.4",
-    "tailwindcss": "^4.1.15",
+    "@vitejs/plugin-react": "^5.1.0",
+    "tailwindcss": "^4.1.16",
     "typescript": "^5.9.3",
     "vite-tsconfig-paths": "^5.1.4"
   }

package/template/tanstack-start/src/routes/docs/$.tsx

@@ -73,28 +73,35 @@ function Page() {
   );
 }
 
-function transformPageTree(tree: PageTree.Folder): PageTree.Folder {
-  function transform<T extends PageTree.Item | PageTree.Separator>(item: T) {
-    if (typeof item.icon !== 'string') return item;
+function transformPageTree(root: PageTree.Root): PageTree.Root {
+  function mapNode<T extends PageTree.Node>(item: T): T {
+    if (typeof item.icon === 'string') {
+      item = {
+        ...item,
+        icon: (
+          <span
+            dangerouslySetInnerHTML={{
+              __html: item.icon,
+            }}
+          />
+        ),
+      };
+    }
 
-    return {
-      ...item,
-      icon: (
-        <span
-          dangerouslySetInnerHTML={{
-            __html: item.icon,
-          }}
-        />
-      ),
-    };
+    if (item.type === 'folder') {
+      return {
+        ...item,
+        index: item.index ? mapNode(item.index) : undefined,
+        children: item.children.map(mapNode),
+      };
+    }
+
+    return item;
   }
 
   return {
-    ...tree,
-    index: tree.index ? transform(tree.index) : undefined,
-    children: tree.children.map((item) => {
-      if (item.type === 'folder') return transformPageTree(item);
-      return transform(item);
-    }),
+    ...root,
+    children: root.children.map(mapNode),
+    fallback: root.fallback ? transformPageTree(root.fallback) : undefined,
   };
 }

package/template/tanstack-start-spa/README.md

@@ -0,0 +1,12 @@
+This is a Tanstack Start application generated with
+[Create Fumadocs](https://github.com/fuma-nama/fumadocs).
+
+Run development server:
+
+```bash
+npm run dev
+# or
+pnpm dev
+# or
+yarn dev
+```

package/template/tanstack-start-spa/content/docs/index.mdx

@@ -0,0 +1,34 @@
+---
+title: Hello World
+description: Your favourite docs framework.
+icon: Rocket
+---
+
+Hey there! Fumadocs is the docs framework that also works on Tanstack Start!
+
+## Heading
+
+Hello World!
+
+<Cards>
+  <Card
+    title="Learn more about Tanstack Start"
+    href="https://tanstack.com/start"
+  />
+  <Card title="Learn more about Fumadocs" href="https://fumadocs.dev" />
+</Cards>
+
+### CodeBlock
+
+```ts
+console.log('Hello World');
+```
+
+#### Table
+
+| Head                            | Description                         |
+| ------------------------------- | ----------------------------------- |
+| `hello`                         | Hello World                         |
+| very **important**              | Hey                                 |
+| _Surprisingly_                  | Fumadocs                            |
+| very long text that looks weird | hello world hello world hello world |

package/template/tanstack-start-spa/content/docs/test.mdx

@@ -0,0 +1,12 @@
+---
+title: Test
+description: This is another page
+---
+
+Hello World again!
+
+## Installation
+
+```npm
+npm i fumadocs-core fumadocs-ui
+```

package/template/tanstack-start-spa/example.gitignore

@@ -0,0 +1,19 @@
+node_modules
+
+.DS_Store
+.cache
+.vercel
+.output
+.nitro
+/build/
+/api/
+/server/build
+/public/build
+/test-results/
+/playwright-report/
+/blob-report/
+/playwright/.cache/
+.tanstack
+
+src/routeTree.gen.ts
+.source

package/template/tanstack-start-spa/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "example-tanstack-start-spa",
+  "private": true,
+  "sideEffects": false,
+  "type": "module",
+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build",
+    "start": "serve dist/client"
+  },
+  "dependencies": {
+    "@orama/orama": "^3.1.16",
+    "@tanstack/react-router": "^1.133.32",
+    "@tanstack/react-router-devtools": "^1.133.34",
+    "@tanstack/react-start": "^1.133.34",
+    "@tanstack/start-static-server-functions": "^1.133.34",
+    "fumadocs-core": "workspace:*",
+    "fumadocs-mdx": "workspace:*",
+    "fumadocs-ui": "workspace:*",
+    "lucide-static": "^0.548.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "tailwind-merge": "^3.3.1",
+    "vite": "^7.1.12"
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "^4.1.16",
+    "@types/mdx": "^2.0.13",
+    "@types/node": "^24.9.1",
+    "@types/react": "^19.2.2",
+    "@types/react-dom": "^19.2.2",
+    "@vitejs/plugin-react": "^5.1.0",
+    "serve": "^14.2.5",
+    "tailwindcss": "^4.1.16",
+    "typescript": "^5.9.3",
+    "vite-tsconfig-paths": "^5.1.4"
+  }
+}

package/template/tanstack-start-spa/source.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig, defineDocs } from 'fumadocs-mdx/config';
+
+export const docs = defineDocs({
+  dir: 'content/docs',
+});
+
+export default defineConfig();

package/template/tanstack-start-spa/src/components/not-found.tsx

@@ -0,0 +1,28 @@
+import { Link } from '@tanstack/react-router';
+import { HomeLayout } from 'fumadocs-ui/layouts/home';
+
+export function NotFound() {
+  return (
+    <HomeLayout
+      nav={{
+        title: 'Tanstack Start',
+      }}
+      className="text-center py-32 justify-center"
+    >
+      <div className="flex flex-col items-center gap-4">
+        <h1 className="text-6xl font-bold text-fd-muted-foreground">404</h1>
+        <h2 className="text-2xl font-semibold">Page Not Found</h2>
+        <p className="text-fd-muted-foreground max-w-md">
+          The page you are looking for might have been removed, had its name
+          changed, or is temporarily unavailable.
+        </p>
+        <Link
+          to="/"
+          className="mt-4 px-4 py-2 rounded-lg bg-fd-primary text-fd-primary-foreground font-medium text-sm hover:opacity-90 transition-opacity"
+        >
+          Back to Home
+        </Link>
+      </div>
+    </HomeLayout>
+  );
+}

package/template/tanstack-start-spa/src/components/search.tsx

@@ -0,0 +1,51 @@
+'use client';
+import {
+  SearchDialog,
+  SearchDialogClose,
+  SearchDialogContent,
+  SearchDialogHeader,
+  SearchDialogIcon,
+  SearchDialogInput,
+  SearchDialogList,
+  SearchDialogOverlay,
+  type SharedProps,
+} from 'fumadocs-ui/components/dialog/search';
+import { useDocsSearch } from 'fumadocs-core/search/client';
+import { create } from '@orama/orama';
+import { useI18n } from 'fumadocs-ui/contexts/i18n';
+
+function initOrama() {
+  return create({
+    schema: { _: 'string' },
+    // https://docs.orama.com/docs/orama-js/supported-languages
+    language: 'english',
+  });
+}
+
+export default function DefaultSearchDialog(props: SharedProps) {
+  const { locale } = useI18n(); // (optional) for i18n
+  const { search, setSearch, query } = useDocsSearch({
+    type: 'static',
+    initOrama,
+    locale,
+  });
+
+  return (
+    <SearchDialog
+      search={search}
+      onSearchChange={setSearch}
+      isLoading={query.isLoading}
+      {...props}
+    >
+      <SearchDialogOverlay />
+      <SearchDialogContent>
+        <SearchDialogHeader>
+          <SearchDialogIcon />
+          <SearchDialogInput />
+          <SearchDialogClose />
+        </SearchDialogHeader>
+        <SearchDialogList items={query.data !== 'empty' ? query.data : null} />
+      </SearchDialogContent>
+    </SearchDialog>
+  );
+}

package/template/tanstack-start-spa/src/lib/layout.shared.tsx

@@ -0,0 +1,9 @@
+import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
+
+export function baseOptions(): BaseLayoutProps {
+  return {
+    nav: {
+      title: 'Tanstack Start',
+    },
+  };
+}

package/template/tanstack-start-spa/src/lib/source.ts

@@ -0,0 +1,15 @@
+import { loader } from 'fumadocs-core/source';
+import * as icons from 'lucide-static';
+import { create, docs } from '@/.source';
+
+export const source = loader({
+  source: await create.sourceAsync(docs.doc, docs.meta),
+  baseUrl: '/docs',
+  icon(icon) {
+    if (!icon) {
+      return;
+    }
+
+    if (icon in icons) return icons[icon as keyof typeof icons];
+  },
+});

package/template/tanstack-start-spa/src/router.tsx

@@ -0,0 +1,12 @@
+import { createRouter as createTanStackRouter } from '@tanstack/react-router';
+import { routeTree } from './routeTree.gen';
+import { NotFound } from '@/components/not-found';
+
+export function getRouter() {
+  return createTanStackRouter({
+    routeTree,
+    defaultPreload: 'intent',
+    scrollRestoration: true,
+    defaultNotFoundComponent: NotFound,
+  });
+}

package/template/tanstack-start-spa/src/routes/__root.tsx

@@ -0,0 +1,51 @@
+import {
+  createRootRoute,
+  HeadContent,
+  Outlet,
+  Scripts,
+} from '@tanstack/react-router';
+import * as React from 'react';
+import appCss from '@/styles/app.css?url';
+import { RootProvider } from 'fumadocs-ui/provider/tanstack';
+import SearchDialog from '@/components/search';
+
+export const Route = createRootRoute({
+  head: () => ({
+    meta: [
+      {
+        charSet: 'utf-8',
+      },
+      {
+        name: 'viewport',
+        content: 'width=device-width, initial-scale=1',
+      },
+      {
+        title: 'Fumadocs on TanStack Start',
+      },
+    ],
+    links: [{ rel: 'stylesheet', href: appCss }],
+  }),
+  component: RootComponent,
+});
+
+function RootComponent() {
+  return (
+    <RootDocument>
+      <Outlet />
+    </RootDocument>
+  );
+}
+
+function RootDocument({ children }: { children: React.ReactNode }) {
+  return (
+    <html suppressHydrationWarning>
+      <head>
+        <HeadContent />
+      </head>
+      <body className="flex flex-col min-h-screen">
+        <RootProvider search={{ SearchDialog }}>{children}</RootProvider>
+        <Scripts />
+      </body>
+    </html>
+  );
+}

package/template/tanstack-start-spa/src/routes/api/search.ts

@@ -0,0 +1,16 @@
+import { createFileRoute } from '@tanstack/react-router';
+import { source } from '@/lib/source';
+import { createFromSource } from 'fumadocs-core/search/server';
+
+const server = createFromSource(source, {
+  // https://docs.orama.com/docs/orama-js/supported-languages
+  language: 'english',
+});
+
+export const Route = createFileRoute('/api/search')({
+  server: {
+    handlers: {
+      GET: () => server.staticGET(),
+    },
+  },
+});

package/template/tanstack-start-spa/src/routes/docs/$.tsx

@@ -0,0 +1,109 @@
+import { createFileRoute, notFound } from '@tanstack/react-router';
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import { createServerFn } from '@tanstack/react-start';
+import { source } from '@/lib/source';
+import type * as PageTree from 'fumadocs-core/page-tree';
+import { useMemo } from 'react';
+import { docs } from '@/.source';
+import {
+  DocsBody,
+  DocsDescription,
+  DocsPage,
+  DocsTitle,
+} from 'fumadocs-ui/page';
+import defaultMdxComponents from 'fumadocs-ui/mdx';
+import { createClientLoader } from 'fumadocs-mdx/runtime/vite';
+import { baseOptions } from '@/lib/layout.shared';
+import { staticFunctionMiddleware } from '@tanstack/start-static-server-functions';
+
+export const Route = createFileRoute('/docs/$')({
+  component: Page,
+  loader: async ({ params }) => {
+    const slugs = params._splat?.split('/') ?? [];
+    const data = await loader({ data: slugs });
+    await clientLoader.preload(data.path);
+    return data;
+  },
+});
+
+const loader = createServerFn({
+  method: 'GET',
+})
+  .inputValidator((slugs: string[]) => slugs)
+  .middleware([staticFunctionMiddleware])
+  .handler(async ({ data: slugs }) => {
+    const page = source.getPage(slugs);
+    if (!page) throw notFound();
+
+    return {
+      tree: source.pageTree as object,
+      path: page.path,
+    };
+  });
+
+const clientLoader = createClientLoader(docs.doc, {
+  id: 'docs',
+  component({ toc, frontmatter, default: MDX }) {
+    return (
+      <DocsPage toc={toc}>
+        <DocsTitle>{frontmatter.title}</DocsTitle>
+        <DocsDescription>{frontmatter.description}</DocsDescription>
+        <DocsBody>
+          <MDX
+            components={{
+              ...defaultMdxComponents,
+            }}
+          />
+        </DocsBody>
+      </DocsPage>
+    );
+  },
+});
+
+function Page() {
+  const data = Route.useLoaderData();
+  const Content = clientLoader.getComponent(data.path);
+  const tree = useMemo(
+    () => transformPageTree(data.tree as PageTree.Folder),
+    [data.tree],
+  );
+
+  return (
+    <DocsLayout {...baseOptions()} tree={tree}>
+      <Content />
+    </DocsLayout>
+  );
+}
+
+function transformPageTree(root: PageTree.Root): PageTree.Root {
+  function mapNode<T extends PageTree.Node>(item: T): T {
+    if (typeof item.icon === 'string') {
+      item = {
+        ...item,
+        icon: (
+          <span
+            dangerouslySetInnerHTML={{
+              __html: item.icon,
+            }}
+          />
+        ),
+      };
+    }
+
+    if (item.type === 'folder') {
+      return {
+        ...item,
+        index: item.index ? mapNode(item.index) : undefined,
+        children: item.children.map(mapNode),
+      };
+    }
+
+    return item;
+  }
+
+  return {
+    ...root,
+    children: root.children.map(mapNode),
+    fallback: root.fallback ? transformPageTree(root.fallback) : undefined,
+  };
+}

package/template/tanstack-start-spa/src/routes/index.tsx

@@ -0,0 +1,24 @@
+import { createFileRoute, Link } from '@tanstack/react-router';
+import { HomeLayout } from 'fumadocs-ui/layouts/home';
+import { baseOptions } from '@/lib/layout.shared';
+
+export const Route = createFileRoute('/')({
+  component: Home,
+});
+
+function Home() {
+  return (
+    <HomeLayout {...baseOptions()} className="text-center py-32 justify-center">
+      <h1 className="font-medium text-xl mb-4">Fumadocs on Tanstack Start.</h1>
+      <Link
+        to="/docs/$"
+        params={{
+          _splat: '',
+        }}
+        className="px-3 py-2 rounded-lg bg-fd-primary text-fd-primary-foreground font-medium text-sm mx-auto"
+      >
+        Open Docs
+      </Link>
+    </HomeLayout>
+  );
+}

package/template/tanstack-start-spa/src/styles/app.css

@@ -0,0 +1,3 @@
+@import 'tailwindcss';
+@import 'fumadocs-ui/css/neutral.css';
+@import 'fumadocs-ui/css/preset.css';

package/template/tanstack-start-spa/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "include": ["**/*.ts", "**/*.tsx"],
+  "compilerOptions": {
+    "strict": true,
+    "esModuleInterop": true,
+    "jsx": "react-jsx",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["DOM", "DOM.Iterable", "ES2022"],
+    "types": ["vite/client"],
+    "isolatedModules": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true,
+    "target": "ES2022",
+    "allowJs": true,
+    "forceConsistentCasingInFileNames": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"],
+      "@/.source": [".source"]
+    },
+    "noEmit": true
+  }
+}

package/template/tanstack-start-spa/vite.config.ts

@@ -0,0 +1,39 @@
+import react from '@vitejs/plugin-react';
+import { tanstackStart } from '@tanstack/react-start/plugin/vite';
+import { defineConfig } from 'vite';
+import tsConfigPaths from 'vite-tsconfig-paths';
+import tailwindcss from '@tailwindcss/vite';
+import mdx from 'fumadocs-mdx/vite';
+
+export default defineConfig({
+  server: {
+    port: 3000,
+  },
+  plugins: [
+    mdx(await import('./source.config')),
+    tailwindcss(),
+    tsConfigPaths({
+      projects: ['./tsconfig.json'],
+    }),
+    tanstackStart({
+      spa: {
+        enabled: true,
+        prerender: {
+          outputPath: 'index.html',
+          enabled: true,
+          crawlLinks: true,
+        },
+      },
+
+      pages: [
+        {
+          path: '/docs',
+        },
+        {
+          path: '/api/search',
+        },
+      ],
+    }),
+    react(),
+  ],
+});

package/template/waku/package.json

@@ -15,17 +15,17 @@
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "react-server-dom-webpack": "^19.2.0",
-    "waku": "^0.26.1"
+    "waku": "^0.27.0"
   },
   "devDependencies": {
-    "@tailwindcss/vite": "^4.1.15",
+    "@tailwindcss/vite": "^4.1.16",
     "@types/mdx": "^2.0.13",
     "@types/node": "^24.9.1",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
-    "tailwindcss": "^4.1.15",
+    "tailwindcss": "^4.1.16",
     "typescript": "^5.9.3",
-    "vite": "^7.1.11",
+    "vite": "^7.1.12",
     "vite-tsconfig-paths": "^5.1.4"
   }
 }