create-fumadocs-app 15.6.5 → 15.6.6

package/dist/{chunk-J4NXLHNR.js → chunk-VLVSDHVS.js}

@@ -59,7 +59,7 @@ async function tryGitInit(cwd2) {
 }
 
 // src/versions.js
-var versions = { "fumadocs-core": "15.6.5", "fumadocs-ui": "15.6.5", "fumadocs-mdx": "11.7.0", "@fumadocs/mdx-remote": "1.4.0", "@fumadocs/content-collections": "1.2.1" };
+var versions = { "fumadocs-core": "15.6.6", "fumadocs-ui": "15.6.6", "fumadocs-mdx": "11.7.1", "@fumadocs/mdx-remote": "1.4.0", "@fumadocs/content-collections": "1.2.1" };
 
 // ../create-app-versions/package.json
 var package_default = {
@@ -72,25 +72,25 @@ var package_default = {
     "@content-collections/core": "^0.10.0",
     "@content-collections/mdx": "^0.2.2",
     "@content-collections/next": "^0.2.6",
-    "@react-router/dev": "^7.7.0",
-    "@react-router/node": "^7.7.0",
-    "@react-router/serve": "^7.7.0",
+    "@react-router/dev": "^7.7.1",
+    "@react-router/node": "^7.7.1",
+    "@react-router/serve": "^7.7.1",
     "@tailwindcss/postcss": "^4.1.11",
     "@tailwindcss/vite": "^4.1.11",
-    "@tanstack/react-router": "^1.128.8",
-    "@tanstack/react-start": "^1.128.8",
+    "@tanstack/react-router": "^1.129.0",
+    "@tanstack/react-start": "^1.129.0",
     "@types/mdx": "^2.0.13",
-    "@types/node": "24.0.15",
+    "@types/node": "24.1.0",
     "@types/react": "^19.1.8",
     "@types/react-dom": "^19.1.6",
     "@vitejs/plugin-react": "^4.7.0",
     "gray-matter": "^4.0.3",
     isbot: "^5.1.28",
-    next: "15.4.2",
+    next: "15.4.4",
     postcss: "^8.5.6",
     react: "^19.1.0",
     "react-dom": "^19.1.0",
-    "react-router": "^7.7.0",
+    "react-router": "^7.7.1",
     "react-router-devtools": "^5.0.6",
     shiki: "^3.8.1",
     tailwindcss: "^4.1.11",

package/dist/create-app.js

@@ -1,7 +1,7 @@
 import {
   create,
   templates
-} from "./chunk-J4NXLHNR.js";
+} from "./chunk-VLVSDHVS.js";
 export {
   create,
   templates

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   getPackageManager,
   managers,
   templates
-} from "./chunk-J4NXLHNR.js";
+} from "./chunk-VLVSDHVS.js";
 
 // src/index.ts
 import fs from "fs/promises";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-fumadocs-app",
-  "version": "15.6.5",
+  "version": "15.6.6",
   "description": "Create a new documentation site with Fumadocs",
   "keywords": [
     "NextJs",
@@ -28,7 +28,7 @@
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",
-    "@types/node": "24.0.15",
+    "@types/node": "24.1.0",
     "tinyglobby": "^0.2.14",
     "eslint-config-custom": "0.0.0",
     "tsconfig": "0.0.0"

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

@@ -7,36 +7,42 @@ import {
   DocsTitle,
 } from 'fumadocs-ui/page';
 import { source } from '@/source';
+import { type PageTree } from 'fumadocs-core/server';
 import defaultMdxComponents from 'fumadocs-ui/mdx';
-import { executeMdxSync } from '@fumadocs/mdx-remote/client';
-import type { PageTree } from 'fumadocs-core/server';
-import { createCompiler } from '@fumadocs/mdx-remote';
-import * as path from 'node:path';
-
-const compiler = createCompiler({
-  development: false,
-});
+import { docs } from '../../source.generated';
+import { toClientRenderer } from 'fumadocs-mdx/runtime/vite';
 
 export async function loader({ params }: Route.LoaderArgs) {
   const slugs = params['*'].split('/').filter((v) => v.length > 0);
   const page = source.getPage(slugs);
   if (!page) throw new Response('Not found', { status: 404 });
 
-  const compiled = await compiler.compileFile({
-    path: path.resolve('content/docs', page.path),
-    value: page.data.content,
-  });
-
   return {
-    page,
-    compiled: compiled.toString(),
+    path: page.path,
     tree: source.pageTree,
   };
 }
 
+const renderer = toClientRenderer(
+  docs.doc,
+  ({ toc, default: Mdx, frontmatter }) => {
+    return (
+      <DocsPage toc={toc}>
+        <title>{frontmatter.title}</title>
+        <meta name="description" content={frontmatter.description} />
+        <DocsTitle>{frontmatter.title}</DocsTitle>
+        <DocsDescription>{frontmatter.description}</DocsDescription>
+        <DocsBody>
+          <Mdx components={{ ...defaultMdxComponents }} />
+        </DocsBody>
+      </DocsPage>
+    );
+  },
+);
+
 export default function Page(props: Route.ComponentProps) {
-  const { page, compiled, tree } = props.loaderData;
-  const { default: Mdx, toc } = executeMdxSync(compiled);
+  const { tree, path } = props.loaderData;
+  const Content = renderer[path];
 
   return (
     <DocsLayout
@@ -45,15 +51,7 @@ export default function Page(props: Route.ComponentProps) {
       }}
       tree={tree as PageTree.Root}
     >
-      <title>{page.data.title}</title>
-      <meta name="description" content={page.data.description} />
-      <DocsPage toc={toc}>
-        <DocsTitle>{page.data.title}</DocsTitle>
-        <DocsDescription>{page.data.description}</DocsDescription>
-        <DocsBody>
-          <Mdx components={defaultMdxComponents} />
-        </DocsBody>
-      </DocsPage>
+      <Content />
     </DocsLayout>
   );
 }

package/template/react-router/app/docs/search.ts

@@ -1,16 +1,9 @@
 import type { Route } from './+types/search';
-import { createSearchAPI } from 'fumadocs-core/search/server';
+import { createFromSource } from 'fumadocs-core/search/server';
 import { source } from '@/source';
-import { structure } from 'fumadocs-core/mdx-plugins';
 
-const server = createSearchAPI('advanced', {
-  indexes: source.getPages().map((page) => ({
-    id: page.url,
-    url: page.url,
-    title: page.data.title ?? '',
-    description: page.data.description,
-    structuredData: structure(page.data.content),
-  })),
+const server = createFromSource(source, {
+  language: 'english',
 });
 
 export async function loader({ request }: Route.LoaderArgs) {

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

@@ -1,60 +1,7 @@
-import {
-  loader,
-  type MetaData,
-  type PageData,
-  type Source,
-  type VirtualFile,
-} from 'fumadocs-core/source';
-import matter from 'gray-matter';
-import * as path from 'node:path';
-
-const files = Object.entries(
-  import.meta.glob<true, 'raw'>('/content/docs/**/*', {
-    eager: true,
-    query: '?raw',
-    import: 'default',
-  }),
-);
-
-const virtualFiles: VirtualFile[] = files.flatMap(([file, content]) => {
-  const ext = path.extname(file);
-  const virtualPath = path.relative(
-    'content/docs',
-    path.join(process.cwd(), file),
-  );
-
-  if (ext === '.mdx' || ext === '.md') {
-    const parsed = matter(content);
-
-    return {
-      type: 'page',
-      path: virtualPath,
-      data: {
-        ...parsed.data,
-        content: parsed.content,
-      },
-    };
-  }
-
-  if (ext === '.json') {
-    return {
-      type: 'meta',
-      path: virtualPath,
-      data: JSON.parse(content),
-    };
-  }
-
-  return [];
-});
+import { loader } from 'fumadocs-core/source';
+import { create, docs } from '../source.generated';
 
 export const source = loader({
-  source: {
-    files: virtualFiles,
-  } as Source<{
-    pageData: PageData & {
-      content: string;
-    };
-    metaData: MetaData;
-  }>,
+  source: await create.sourceAsync(docs.doc, docs.meta),
   baseUrl: '/docs',
 });

package/template/react-router/package.json

@@ -1,4 +1,5 @@
 {
+  "name": "example-react-router",
   "private": true,
   "type": "module",
   "scripts": {
@@ -8,28 +9,26 @@
     "typecheck": "react-router typegen && tsc"
   },
   "dependencies": {
-    "@fumadocs/mdx-remote": "workspace:*",
-    "@react-router/node": "^7.6.3",
-    "@react-router/serve": "^7.6.3",
+    "@react-router/node": "^7.7.0",
+    "@react-router/serve": "^7.7.0",
     "fumadocs-core": "workspace:*",
+    "fumadocs-mdx": "workspace:*",
     "fumadocs-ui": "workspace:*",
-    "gray-matter": "^4.0.3",
     "isbot": "^5.1.28",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
-    "react-router": "^7.6.3",
-    "shiki": "^3.8.0"
+    "react-router": "^7.7.0"
   },
   "devDependencies": {
-    "@react-router/dev": "^7.6.3",
+    "@react-router/dev": "^7.7.0",
     "@tailwindcss/vite": "^4.1.11",
-    "@types/node": "^24.0.13",
+    "@types/node": "^24.0.15",
     "@types/react": "^19.1.8",
     "@types/react-dom": "^19.1.6",
     "react-router-devtools": "^5.0.6",
     "tailwindcss": "^4.1.11",
     "typescript": "^5.8.3",
-    "vite": "^7.0.4",
+    "vite": "^7.0.5",
     "vite-tsconfig-paths": "^5.1.4"
   }
 }

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

@@ -1,9 +1,5 @@
 import type { Config } from '@react-router/dev/config';
-import { source } from './app/source';
 
 export default {
   ssr: true,
-  async prerender({ getStaticPaths }) {
-    return [...getStaticPaths(), ...source.getPages().map((page) => page.url)];
-  },
 } satisfies Config;

package/template/react-router/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/react-router/vite.config.ts

@@ -2,12 +2,9 @@ import { reactRouter } from '@react-router/dev/vite';
 import tailwindcss from '@tailwindcss/vite';
 import { defineConfig } from 'vite';
 import tsconfigPaths from 'vite-tsconfig-paths';
+import mdx from 'fumadocs-mdx/vite';
+import * as MdxConfig from './source.config';
 
 export default defineConfig({
-  build: {
-    rollupOptions: {
-      external: ['shiki'],
-    },
-  },
-  plugins: [tailwindcss(), reactRouter(), tsconfigPaths()],
+  plugins: [mdx(MdxConfig), tailwindcss(), reactRouter(), tsconfigPaths()],
 });

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

@@ -5,6 +5,8 @@ description: This is another page
 
 Hello World again!
 
+## Installation
+
 ```npm
 npm i fumadocs-core fumadocs-ui
 ```

package/template/tanstack-start/package.json

@@ -1,4 +1,5 @@
 {
+  "name": "example-tanstack-start",
   "private": true,
   "sideEffects": false,
   "type": "module",
@@ -8,28 +9,26 @@
     "start": "node .output/server/index.mjs"
   },
   "dependencies": {
-    "@fumadocs/mdx-remote": "workspace:*",
-    "@tanstack/react-router": "^1.128.0",
-    "@tanstack/react-router-devtools": "^1.128.0",
-    "@tanstack/react-start": "^1.128.1",
+    "@tanstack/react-router": "^1.129.0",
+    "@tanstack/react-router-devtools": "^1.129.0",
+    "@tanstack/react-start": "^1.129.0",
     "fumadocs-core": "workspace:*",
+    "fumadocs-mdx": "workspace:*",
     "fumadocs-ui": "workspace:*",
-    "gray-matter": "^4.0.3",
     "lucide-static": "^0.525.0",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
     "tailwind-merge": "^3.3.1",
-    "vite": "^7.0.5",
-    "zod": "^4.0.5"
+    "vite": "^7.0.5"
   },
   "devDependencies": {
     "@tailwindcss/vite": "^4.1.11",
-    "@types/node": "^24.0.14",
-    "@types/react": "^19.1.8",
-    "@types/react-dom": "^19.1.6",
-    "@vitejs/plugin-react": "^4.6.0",
+    "@types/node": "^24.0.15",
+    "@types/react": "^19.0.8",
+    "@types/react-dom": "^19.0.3",
+    "@vitejs/plugin-react": "^4.7.0",
     "tailwindcss": "^4.1.11",
-    "typescript": "^5.8.3",
+    "typescript": "^5.7.2",
     "vite-tsconfig-paths": "^5.1.4"
   }
 }

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

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

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

@@ -1,59 +1,9 @@
-import {
-  loader,
-  type MetaData,
-  type PageData,
-  type Source,
-  type VirtualFile,
-} from 'fumadocs-core/source';
-import matter from 'gray-matter';
-import * as path from 'node:path';
+import { loader } from 'fumadocs-core/source';
 import * as icons from 'lucide-static';
-
-const files = Object.entries(
-  import.meta.glob<true, 'raw'>('/content/**/*', {
-    eager: true,
-    query: '?raw',
-    import: 'default',
-  }),
-);
-
-const virtualFiles: VirtualFile[] = files.flatMap(([file, content]) => {
-  const ext = path.extname(file);
-  const virtualPath = path.relative('content', path.join(process.cwd(), file));
-
-  if (ext === '.mdx' || ext === '.md') {
-    const parsed = matter(content);
-
-    return {
-      type: 'page',
-      path: virtualPath,
-      data: {
-        ...parsed.data,
-        content: parsed.content,
-      },
-    };
-  }
-
-  if (ext === '.json') {
-    return {
-      type: 'meta',
-      path: virtualPath,
-      data: JSON.parse(content),
-    };
-  }
-
-  return [];
-});
+import { create, docs } from '../../source.generated';
 
 export const source = loader({
-  source: {
-    files: virtualFiles,
-  } as Source<{
-    pageData: PageData & {
-      content: string;
-    };
-    metaData: MetaData;
-  }>,
+  source: await create.sourceAsync(docs.doc, docs.meta),
   baseUrl: '/docs',
   // @ts-expect-error -- string
   icon(icon) {

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

@@ -1,6 +1,6 @@
 import { createRouter as createTanStackRouter } from '@tanstack/react-router';
 import { routeTree } from './routeTree.gen';
-import { NotFound } from './components/NotFound';
+import { NotFound } from '~/components/not-found';
 
 export function createRouter() {
   return createTanStackRouter({

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

@@ -1,16 +1,8 @@
 import { createServerFileRoute } from '@tanstack/react-start/server';
-import { createSearchAPI } from 'fumadocs-core/search/server';
 import { source } from '~/lib/source';
-import { structure } from 'fumadocs-core/mdx-plugins';
+import { createFromSource } from 'fumadocs-core/search/server';
 
-const server = createSearchAPI('advanced', {
-  indexes: source.getPages().map((page) => ({
-    id: page.url,
-    url: page.url,
-    title: page.data.title!,
-    structuredData: structure(page.data.content),
-  })),
-});
+const server = createFromSource(source);
 
 export const ServerRoute = createServerFileRoute('/api/search').methods({
   GET: async ({ request }) => server.GET(request),

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

@@ -1,27 +1,25 @@
 import { createFileRoute, notFound } from '@tanstack/react-router';
-import { executeMdxSync } from '@fumadocs/mdx-remote/client';
 import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import { createServerFn } from '@tanstack/react-start';
+import { source } from '~/lib/source';
+import type { PageTree } from 'fumadocs-core/server';
+import { useMemo } from 'react';
+import { docs } from '../../../source.generated';
 import {
   DocsBody,
   DocsDescription,
   DocsPage,
   DocsTitle,
 } from 'fumadocs-ui/page';
-import { createServerFn } from '@tanstack/react-start';
-import { createCompiler } from '@fumadocs/mdx-remote';
-import { source } from '~/lib/source';
-import path from 'node:path';
 import defaultMdxComponents from 'fumadocs-ui/mdx';
-import type { PageTree } from 'fumadocs-core/server';
-import { useMemo } from 'react';
-
-const compiler = createCompiler();
+import { createClientLoader } from 'fumadocs-mdx/runtime/vite';
 
 export const Route = createFileRoute('/docs/$')({
   component: Page,
   loader: async ({ params }) => {
-    const slugs = (params._splat ?? '').split('/');
-    return loader({ data: slugs });
+    const data = await loader({ data: params._splat?.split('/') ?? [] });
+    await clientLoader.preload(data.path);
+    return data;
   },
 });
 
@@ -34,48 +32,38 @@ const loader = createServerFn({
     const page = source.getPage(slugs);
     if (!page) throw notFound();
 
-    const { content, ...rest } = page.data;
-    const compiled = await compiler.compileFile({
-      path: path.resolve('content', page.path),
-      value: content,
-    });
-
     return {
       tree: source.pageTree as object,
-      ...rest,
-      compiled: compiled.toString(),
+      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 {
-    default: MDX,
-    toc,
-    tree,
-  } = useMemo(() => {
-    const result = executeMdxSync(data.compiled);
-
-    function traverse(folder: PageTree.Folder | PageTree.Root) {
-      for (const node of folder.children) {
-        if (node.type === 'page' && typeof node.icon === 'string') {
-          node.icon = (
-            <span
-              dangerouslySetInnerHTML={{
-                __html: node.icon,
-              }}
-            />
-          );
-        }
-
-        if (node.type === 'folder') traverse(node);
-      }
-    }
-
-    const tree = structuredClone(data.tree) as PageTree.Root;
-    traverse(tree);
-    return { ...result, tree };
-  }, [data]);
+  const Content = clientLoader.getComponent(data.path);
+  const tree = useMemo(
+    () => transformPageTree(data.tree as PageTree.Folder),
+    [data.tree],
+  );
 
   return (
     <DocsLayout
@@ -84,17 +72,34 @@ function Page() {
         title: 'Fumadocs Tanstack',
       }}
     >
-      <DocsPage toc={toc}>
-        <DocsTitle>{data.title}</DocsTitle>
-        <DocsDescription>{data.description}</DocsDescription>
-        <DocsBody>
-          <MDX
-            components={{
-              ...defaultMdxComponents,
-            }}
-          />
-        </DocsBody>
-      </DocsPage>
+      <Content />
     </DocsLayout>
   );
 }
+
+function transformPageTree(tree: PageTree.Folder): PageTree.Folder {
+  function page(item: PageTree.Item) {
+    if (typeof item.icon !== 'string') return item;
+
+    return {
+      ...item,
+      icon: (
+        <span
+          dangerouslySetInnerHTML={{
+            __html: item.icon,
+          }}
+        />
+      ),
+    };
+  }
+
+  return {
+    ...tree,
+    index: tree.index ? page(tree.index) : undefined,
+    children: tree.children.map((item) => {
+      if (item.type === 'page') return page(item);
+      if (item.type === 'folder') return transformPageTree(item);
+      return item;
+    }),
+  };
+}

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

@@ -1,14 +1,16 @@
+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 react from '@vitejs/plugin-react';
+import mdx from 'fumadocs-mdx/vite';
 
 export default defineConfig({
   server: {
     port: 3000,
   },
   plugins: [
+    mdx(await import('./source.config')),
     tailwindcss(),
     tsConfigPaths({
       projects: ['./tsconfig.json'],