create-fumadocs-app 16.0.14 → 16.0.16

package/dist/bin.js

@@ -3,11 +3,11 @@ import {
   create,
   getPackageManager,
   managers
-} from "./chunk-KWHTQK4F.js";
+} from "./chunk-N5FFRBR2.js";
 import {
   isCI,
   templates
-} from "./chunk-Q3YZFITQ.js";
+} from "./chunk-NJNDK2R6.js";
 
 // src/bin.ts
 import fs from "fs/promises";

package/dist/{chunk-KWHTQK4F.js → chunk-N5FFRBR2.js}

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

package/dist/{chunk-Q3YZFITQ.js → chunk-NJNDK2R6.js}

@@ -94,11 +94,11 @@ import { fileURLToPath } from "url";
 // ../create-app-versions/package.json
 var package_default = {
   name: "create-fumadocs-versions",
-  version: "16.0.14",
+  version: "16.0.16",
   private: true,
   description: "Used to track dependency versions in create-fumadocs-app",
   dependencies: {
-    "@biomejs/biome": "^2.3.3",
+    "@biomejs/biome": "^2.3.5",
     "@eslint/eslintrc": "^3.3.1",
     "@orama/core": "^1.2.13",
     eslint: "^9.39.1",
@@ -109,13 +109,13 @@ var package_default = {
 };
 
 // ../core/package.json
-var version = "16.0.11";
+var version = "16.0.13";
 
 // ../ui/package.json
-var version2 = "16.0.11";
+var version2 = "16.0.13";
 
 // ../mdx/package.json
-var version3 = "13.0.8";
+var version3 = "14.0.1";
 
 // src/constants.ts
 var sourceDir = fileURLToPath(new URL(`../`, import.meta.url).href);

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   create
-} from "./chunk-KWHTQK4F.js";
-import "./chunk-Q3YZFITQ.js";
+} from "./chunk-N5FFRBR2.js";
+import "./chunk-NJNDK2R6.js";
 export {
   create
 };

package/dist/plugins/biome.js

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

package/dist/plugins/eslint.js

@@ -2,7 +2,7 @@ import {
   depVersions,
   pick,
   writeFile
-} from "../chunk-Q3YZFITQ.js";
+} from "../chunk-NJNDK2R6.js";
 
 // src/plugins/eslint.ts
 import path from "path";

package/dist/plugins/orama-cloud.js

@@ -4,7 +4,7 @@ import {
   pick,
   sourceDir,
   writeFile
-} from "../chunk-Q3YZFITQ.js";
+} from "../chunk-NJNDK2R6.js";
 
 // src/plugins/orama-cloud.ts
 import path2 from "path";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-fumadocs-app",
-  "version": "16.0.14",
+  "version": "16.0.16",
   "description": "Create a new documentation site with Fumadocs",
   "keywords": [
     "react",
@@ -39,7 +39,7 @@
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",
-    "@types/node": "24.10.0",
+    "@types/node": "24.10.1",
     "tinyglobby": "^0.2.15",
     "typescript": "^5.9.3",
     "eslint-config-custom": "0.0.0",

package/template/+next+fuma-docs-mdx/lib/source.ts

@@ -1,4 +1,4 @@
-import { docs } from '@/.source';
+import { docs } from 'fumadocs-mdx:collections/server';
 import { type InferPageType, loader } from 'fumadocs-core/source';
 import { lucideIconsPlugin } from 'fumadocs-core/source/lucide-icons';
 

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

@@ -5,7 +5,8 @@
   "scripts": {
     "build": "next build",
     "dev": "next dev",
-    "start": "next start"
+    "start": "next start",
+    "types:check": "fumadocs-mdx && tsc --noEmit"
   },
   "dependencies": {
     "fumadocs-core": "workspace:*",

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

@@ -17,7 +17,7 @@
     "incremental": true,
     "paths": {
       "@/*": ["./*"],
-      "@/.source": [".source"]
+      "fumadocs-mdx:collections/*": [".source/*"]
     },
     "plugins": [
       {

package/template/react-router/app/docs/page.tsx

@@ -9,8 +9,7 @@ import {
 import { source } from '@/lib/source';
 import type * as PageTree from 'fumadocs-core/page-tree';
 import defaultMdxComponents from 'fumadocs-ui/mdx';
-import { docs } from '@/.source';
-import { toClientRenderer } from 'fumadocs-mdx/runtime/vite';
+import browserCollections from 'fumadocs-mdx:collections/browser';
 import { baseOptions } from '@/lib/layout.shared';
 
 export async function loader({ params }: Route.LoaderArgs) {
@@ -24,9 +23,8 @@ export async function loader({ params }: Route.LoaderArgs) {
   };
 }
 
-const renderer = toClientRenderer(
-  docs.doc,
-  ({ toc, default: Mdx, frontmatter }) => {
+const clientLoader = browserCollections.docs.createClientLoader({
+  component({ toc, default: Mdx, frontmatter }) {
     return (
       <DocsPage toc={toc}>
         <title>{frontmatter.title}</title>
@@ -39,11 +37,11 @@ const renderer = toClientRenderer(
       </DocsPage>
     );
   },
-);
+});
 
 export default function Page({ loaderData }: Route.ComponentProps) {
   const { tree, path } = loaderData;
-  const Content = renderer[path];
+  const Content = clientLoader.getComponent(path);
 
   return (
     <DocsLayout {...baseOptions()} tree={tree as PageTree.Root}>

package/template/react-router/app/lib/source.ts

@@ -1,7 +1,7 @@
 import { loader } from 'fumadocs-core/source';
-import { create, docs } from '@/.source';
+import { docs } from 'fumadocs-mdx:collections/server';
 
 export const source = loader({
-  source: await create.sourceAsync(docs.doc, docs.meta),
+  source: docs.toFumadocsSource(),
   baseUrl: '/docs',
 });

package/template/react-router/content/docs/meta.json

@@ -0,0 +1,3 @@
+{
+  "pages": ["index", "..."]
+}

package/template/react-router/package.json

@@ -6,7 +6,7 @@
     "build": "react-router build",
     "dev": "react-router dev",
     "start": "react-router-serve ./build/server/index.js",
-    "typecheck": "react-router typegen && tsc"
+    "types:check": "react-router typegen && fumadocs-mdx && tsc --noEmit"
   },
   "dependencies": {
     "@react-router/node": "^7.9.5",
@@ -26,10 +26,10 @@
     "@types/node": "^24.10.0",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
-    "react-router-devtools": "^6.0.0",
+    "react-router-devtools": "^5.1.3",
     "tailwindcss": "^4.1.16",
     "typescript": "^5.9.3",
-    "vite": "^7.1.12",
+    "vite": "^7.2.0",
     "vite-tsconfig-paths": "^5.1.4"
   }
 }

package/template/react-router/tsconfig.json

@@ -16,7 +16,7 @@
     "baseUrl": ".",
     "paths": {
       "@/*": ["./app/*"],
-      "@/.source": [".source"]
+      "fumadocs-mdx:collections/*": [".source/*"]
     },
     "esModuleInterop": true,
     "verbatimModuleSyntax": true,

package/template/react-router/vite.config.ts

@@ -6,5 +6,12 @@ import mdx from 'fumadocs-mdx/vite';
 import * as MdxConfig from './source.config';
 
 export default defineConfig({
-  plugins: [mdx(MdxConfig), tailwindcss(), reactRouter(), tsconfigPaths()],
+  plugins: [
+    mdx(MdxConfig),
+    tailwindcss(),
+    reactRouter(),
+    tsconfigPaths({
+      root: __dirname,
+    }),
+  ],
 });

package/template/react-router-spa/app/docs/page.tsx

@@ -9,8 +9,7 @@ import {
 import { source } from '@/lib/source';
 import type * as PageTree from 'fumadocs-core/page-tree';
 import defaultMdxComponents from 'fumadocs-ui/mdx';
-import { docs } from '@/.source';
-import { toClientRenderer } from 'fumadocs-mdx/runtime/vite';
+import browserCollections from 'fumadocs-mdx:collections/browser';
 import { baseOptions } from '@/lib/layout.shared';
 
 export async function loader({ params }: Route.LoaderArgs) {
@@ -24,9 +23,8 @@ export async function loader({ params }: Route.LoaderArgs) {
   };
 }
 
-const renderer = toClientRenderer(
-  docs.doc,
-  ({ toc, default: Mdx, frontmatter }) => {
+const clientLoader = browserCollections.docs.createClientLoader({
+  component({ toc, default: Mdx, frontmatter }) {
     return (
       <DocsPage toc={toc}>
         <title>{frontmatter.title}</title>
@@ -39,11 +37,11 @@ const renderer = toClientRenderer(
       </DocsPage>
     );
   },
-);
+});
 
 export default function Page({ loaderData }: Route.ComponentProps) {
   const { tree, path } = loaderData;
-  const Content = renderer[path];
+  const Content = clientLoader.getComponent(path);
 
   return (
     <DocsLayout {...baseOptions()} tree={tree as PageTree.Root}>

package/template/react-router-spa/app/lib/source.ts

@@ -1,7 +1,7 @@
 import { loader } from 'fumadocs-core/source';
-import { create, docs } from '@/.source';
+import { docs } from 'fumadocs-mdx:collections/server';
 
 export const source = loader({
-  source: await create.sourceAsync(docs.doc, docs.meta),
+  source: docs.toFumadocsSource(),
   baseUrl: '/docs',
 });

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

@@ -6,7 +6,7 @@
     "build": "react-router build",
     "dev": "react-router dev",
     "start": "serve ./build/client",
-    "typecheck": "react-router typegen && tsc"
+    "types:check": "react-router typegen && fumadocs-mdx && tsc --noEmit"
   },
   "dependencies": {
     "@orama/orama": "^3.1.16",
@@ -26,11 +26,11 @@
     "@types/node": "^24.10.0",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
-    "react-router-devtools": "^6.0.0",
+    "react-router-devtools": "^5.1.3",
     "serve": "^14.2.5",
     "tailwindcss": "^4.1.16",
     "typescript": "^5.9.3",
-    "vite": "^7.1.12",
+    "vite": "^7.2.0",
     "vite-tsconfig-paths": "^5.1.4"
   }
 }

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

@@ -16,7 +16,7 @@
     "baseUrl": ".",
     "paths": {
       "@/*": ["./app/*"],
-      "@/.source": [".source"]
+      "fumadocs-mdx:collections/*": [".source/*"]
     },
     "esModuleInterop": true,
     "verbatimModuleSyntax": true,

package/template/react-router-spa/vite.config.ts

@@ -6,5 +6,12 @@ import mdx from 'fumadocs-mdx/vite';
 import * as MdxConfig from './source.config';
 
 export default defineConfig({
-  plugins: [mdx(MdxConfig), tailwindcss(), reactRouter(), tsconfigPaths()],
+  plugins: [
+    mdx(MdxConfig),
+    tailwindcss(),
+    reactRouter(),
+    tsconfigPaths({
+      root: __dirname,
+    }),
+  ],
 });

package/template/tanstack-start/package.json

@@ -6,7 +6,8 @@
   "scripts": {
     "dev": "vite dev",
     "build": "vite build",
-    "start": "node .output/server/index.mjs"
+    "start": "node .output/server/index.mjs",
+    "types:check": "fumadocs-mdx && tsc --noEmit"
   },
   "dependencies": {
     "@tanstack/react-router": "^1.134.12",
@@ -19,7 +20,7 @@
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "tailwind-merge": "^3.3.1",
-    "vite": "^7.1.12"
+    "vite": "^7.2.0"
   },
   "devDependencies": {
     "@tailwindcss/vite": "^4.1.16",
@@ -28,6 +29,7 @@
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
     "@vitejs/plugin-react": "^5.1.0",
+    "nitro": "3.0.1-alpha.1",
     "tailwindcss": "^4.1.16",
     "typescript": "^5.9.3",
     "vite-tsconfig-paths": "^5.1.4"

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

@@ -1,9 +1,9 @@
 import { loader } from 'fumadocs-core/source';
 import * as icons from 'lucide-static';
-import { create, docs } from '@/.source';
+import { docs } from 'fumadocs-mdx:collections/server';
 
 export const source = loader({
-  source: await create.sourceAsync(docs.doc, docs.meta),
+  source: docs.toFumadocsSource(),
   baseUrl: '/docs',
   icon(icon) {
     if (!icon) {

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

@@ -4,7 +4,7 @@ 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 browserCollections from 'fumadocs-mdx:collections/browser';
 import {
   DocsBody,
   DocsDescription,
@@ -12,7 +12,6 @@ import {
   DocsTitle,
 } from 'fumadocs-ui/page';
 import defaultMdxComponents from 'fumadocs-ui/mdx';
-import { createClientLoader } from 'fumadocs-mdx/runtime/vite';
 import { baseOptions } from '@/lib/layout.shared';
 
 export const Route = createFileRoute('/docs/$')({
@@ -39,8 +38,7 @@ const loader = createServerFn({
     };
   });
 
-const clientLoader = createClientLoader(docs.doc, {
-  id: 'docs',
+const clientLoader = browserCollections.docs.createClientLoader({
   component({ toc, frontmatter, default: MDX }) {
     return (
       <DocsPage toc={toc}>

package/template/tanstack-start/tsconfig.json

@@ -17,7 +17,7 @@
     "baseUrl": ".",
     "paths": {
       "@/*": ["./src/*"],
-      "@/.source": [".source"]
+      "fumadocs-mdx:collections/*": [".source/*"]
     },
     "noEmit": true
   }

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

@@ -4,6 +4,7 @@ import { defineConfig } from 'vite';
 import tsConfigPaths from 'vite-tsconfig-paths';
 import tailwindcss from '@tailwindcss/vite';
 import mdx from 'fumadocs-mdx/vite';
+import { nitro } from 'nitro/vite';
 
 export default defineConfig({
   server: {
@@ -21,5 +22,8 @@ export default defineConfig({
       },
     }),
     react(),
+    // see https://tanstack.com/start/latest/docs/framework/react/guide/hosting for hosting config
+    // we configured nitro by default
+    nitro(),
   ],
 });

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

@@ -6,7 +6,8 @@
   "scripts": {
     "dev": "vite dev",
     "build": "vite build",
-    "start": "serve dist/client"
+    "start": "serve dist/client",
+    "types:check": "fumadocs-mdx && tsc --noEmit"
   },
   "dependencies": {
     "@orama/orama": "^3.1.16",
@@ -21,7 +22,7 @@
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "tailwind-merge": "^3.3.1",
-    "vite": "^7.1.12"
+    "vite": "^7.2.0"
   },
   "devDependencies": {
     "@tailwindcss/vite": "^4.1.16",

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

@@ -1,9 +1,9 @@
 import { loader } from 'fumadocs-core/source';
 import * as icons from 'lucide-static';
-import { create, docs } from '@/.source';
+import { docs } from 'fumadocs-mdx:collections/server';
 
 export const source = loader({
-  source: await create.sourceAsync(docs.doc, docs.meta),
+  source: docs.toFumadocsSource(),
   baseUrl: '/docs',
   icon(icon) {
     if (!icon) {

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

@@ -4,7 +4,7 @@ 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 browserCollections from 'fumadocs-mdx:collections/browser';
 import {
   DocsBody,
   DocsDescription,
@@ -12,7 +12,6 @@ import {
   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';
 
@@ -41,8 +40,7 @@ const loader = createServerFn({
     };
   });
 
-const clientLoader = createClientLoader(docs.doc, {
-  id: 'docs',
+const clientLoader = browserCollections.docs.createClientLoader({
   component({ toc, frontmatter, default: MDX }) {
     return (
       <DocsPage toc={toc}>

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

@@ -17,7 +17,7 @@
     "baseUrl": ".",
     "paths": {
       "@/*": ["./src/*"],
-      "@/.source": [".source"]
+      "fumadocs-mdx:collections/*": [".source/*"]
     },
     "noEmit": true
   }

package/template/waku/package.json

@@ -6,7 +6,8 @@
   "scripts": {
     "dev": "waku dev",
     "build": "waku build",
-    "start": "waku start"
+    "start": "waku start",
+    "types:check": "fumadocs-mdx && tsc --noEmit"
   },
   "dependencies": {
     "fumadocs-core": "workspace:*",
@@ -25,7 +26,7 @@
     "@types/react-dom": "^19.2.2",
     "tailwindcss": "^4.1.16",
     "typescript": "^5.9.3",
-    "vite": "^7.1.12",
+    "vite": "^7.2.0",
     "vite-tsconfig-paths": "^5.1.4"
   }
 }

package/template/waku/src/lib/source.ts

@@ -1,7 +1,7 @@
 import { loader } from 'fumadocs-core/source';
-import { create, docs } from '@/.source';
+import { docs } from 'fumadocs-mdx:collections/server';
 
 export const source = loader({
-  source: await create.sourceAsync(docs.doc, docs.meta),
+  source: docs.toFumadocsSource(),
   baseUrl: '/docs',
 });

package/template/waku/tsconfig.json

@@ -1,7 +1,9 @@
 {
   "compilerOptions": {
     "target": "ES2022",
+    "baseUrl": ".",
     "lib": ["dom", "dom.iterable", "ES2022"],
+    "types": ["vite", "vite/client"],
     "jsx": "react-jsx",
     "module": "ESNext",
     "moduleResolution": "bundler",
@@ -16,7 +18,7 @@
     "noEmit": true,
     "paths": {
       "@/*": ["./src/*"],
-      "@/.source": [".source"]
+      "fumadocs-mdx:collections/*": [".source/*"]
     }
   },
   "exclude": ["node_modules", "dist"]

package/template/waku/waku.config.ts

@@ -1,11 +1,12 @@
-import { defineConfig } from 'waku/config';
+import { type Config, defineConfig } from 'waku/config';
 import mdx from 'fumadocs-mdx/vite';
 import * as MdxConfig from './source.config.js';
 import tailwindcss from '@tailwindcss/vite';
 import tsconfigPaths from 'vite-tsconfig-paths';
+import type { UserConfig } from 'vite';
 
 export default defineConfig({
   vite: {
     plugins: [tailwindcss(), mdx(MdxConfig), tsconfigPaths()],
-  },
+  } satisfies UserConfig as Config['vite'],
 });