create-fumadocs-app 15.6.3 → 15.6.5

package/dist/chunk-J4NXLHNR.js

@@ -0,0 +1,330 @@
+// src/create-app.ts
+import path from "path";
+import fs2 from "fs/promises";
+
+// src/git.ts
+import * as fs from "fs/promises";
+import { join } from "path";
+import { x } from "tinyexec";
+async function isInGitRepository(cwd2) {
+  const { exitCode } = await x("git", ["rev-parse", "--is-inside-work-tree"], {
+    nodeOptions: { cwd: cwd2 }
+  });
+  return exitCode !== 0;
+}
+async function isDefaultBranchSet(cwd2) {
+  const { exitCode } = await x("git", ["config", "init.defaultBranch"], {
+    nodeOptions: { cwd: cwd2 }
+  });
+  return exitCode !== 0;
+}
+async function tryGitInit(cwd2) {
+  const { exitCode } = await x("git", ["--version"]);
+  if (exitCode !== 0) return false;
+  if (await isInGitRepository(cwd2)) return false;
+  try {
+    await x("git", ["init"], {
+      throwOnError: true,
+      nodeOptions: { cwd: cwd2 }
+    });
+    if (!await isDefaultBranchSet(cwd2)) {
+      await x("git", ["checkout", "-b", "main"], {
+        throwOnError: true,
+        nodeOptions: {
+          cwd: cwd2
+        }
+      });
+    }
+    await x("git", ["add", "-A"], {
+      throwOnError: true,
+      nodeOptions: {
+        cwd: cwd2
+      }
+    });
+    await x(
+      "git",
+      ["commit", "-m", "Initial commit from Create Fumadocs App"],
+      {
+        throwOnError: true,
+        nodeOptions: {
+          cwd: cwd2
+        }
+      }
+    );
+    return true;
+  } catch {
+    await fs.rmdir(join(cwd2, ".git"), { recursive: true }).catch(() => null);
+    return false;
+  }
+}
+
+// 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" };
+
+// ../create-app-versions/package.json
+var package_default = {
+  name: "example-versions",
+  version: "0.0.0",
+  private: true,
+  description: "Used to track dependency versions in create-fumadocs-app",
+  license: "MIT",
+  dependencies: {
+    "@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",
+    "@tailwindcss/postcss": "^4.1.11",
+    "@tailwindcss/vite": "^4.1.11",
+    "@tanstack/react-router": "^1.128.8",
+    "@tanstack/react-start": "^1.128.8",
+    "@types/mdx": "^2.0.13",
+    "@types/node": "24.0.15",
+    "@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",
+    postcss: "^8.5.6",
+    react: "^19.1.0",
+    "react-dom": "^19.1.0",
+    "react-router": "^7.7.0",
+    "react-router-devtools": "^5.0.6",
+    shiki: "^3.8.1",
+    tailwindcss: "^4.1.11",
+    tinyglobby: "^0.2.14",
+    typescript: "^5.8.3",
+    vinxi: "^0.5.8",
+    vite: "^7.0.5",
+    "vite-tsconfig-paths": "^5.1.4"
+  }
+};
+
+// src/auto-install.ts
+import { x as x2 } from "tinyexec";
+var managers = ["npm", "yarn", "bun", "pnpm"];
+function getPackageManager() {
+  const userAgent = process.env.npm_config_user_agent ?? "";
+  if (userAgent.startsWith("yarn")) {
+    return "yarn";
+  }
+  if (userAgent.startsWith("pnpm")) {
+    return "pnpm";
+  }
+  if (userAgent.startsWith("bun")) {
+    return "bun";
+  }
+  return "npm";
+}
+async function autoInstall(manager, dest) {
+  await x2(manager, ["install"], {
+    throwOnError: true,
+    nodeOptions: {
+      env: {
+        ...process.env,
+        NODE_ENV: "development",
+        DISABLE_OPENCOLLECTIVE: "1"
+      },
+      cwd: dest
+    }
+  });
+}
+
+// src/constants.ts
+import { fileURLToPath } from "url";
+var sourceDir = fileURLToPath(new URL(`../`, import.meta.url).href);
+var cwd = process.cwd();
+
+// src/create-app.ts
+var templates = [
+  "+next+content-collections",
+  "+next+fuma-docs-mdx",
+  "react-router",
+  "tanstack-start"
+];
+async function create(options) {
+  const {
+    installDeps = true,
+    initializeGit = true,
+    log = console.log
+  } = options;
+  const projectName = path.basename(options.outputDir);
+  const dest = path.resolve(cwd, options.outputDir);
+  const isNext = options.template.startsWith("+next");
+  function isRelative(dir, file) {
+    return !path.relative(path.join(dest, dir), file).startsWith(`..${path.sep}`);
+  }
+  function defaultRename(file) {
+    file = file.replace("example.gitignore", ".gitignore");
+    if (!options.useSrcDir || !isNext) {
+      return file;
+    }
+    if (path.basename(file) === "mdx-components.tsx" || isRelative("app", file) || isRelative("lib", file)) {
+      return path.join(dest, "src", path.relative(dest, file));
+    }
+    return file;
+  }
+  if (isNext) {
+    await copy(path.join(sourceDir, `template/+next`), dest, defaultRename);
+    await copy(
+      path.join(sourceDir, `template/${options.template}`),
+      dest,
+      defaultRename
+    );
+    if (options.tailwindcss) {
+      await copy(
+        path.join(sourceDir, `template/+next+tailwindcss`),
+        dest,
+        defaultRename
+      );
+      log("Configured Tailwind CSS");
+    }
+    if (options.eslint) {
+      await copy(
+        path.join(sourceDir, `template/+next+eslint`),
+        dest,
+        defaultRename
+      );
+      log("Configured ESLint");
+    }
+    if (options.useSrcDir) {
+      const tsconfigPath = path.join(dest, "tsconfig.json");
+      const content = (await fs2.readFile(tsconfigPath)).toString();
+      const config = JSON.parse(content);
+      if (config.compilerOptions?.paths) {
+        Object.assign(config.compilerOptions.paths, {
+          "@/*": ["./src/*"]
+        });
+      }
+      await fs2.writeFile(tsconfigPath, JSON.stringify(config, null, 2));
+    }
+  } else {
+    await copy(
+      path.join(sourceDir, `template/${options.template}`),
+      dest,
+      defaultRename
+    );
+  }
+  const packageJson = await createPackageJson(projectName, dest, options);
+  await fs2.writeFile(
+    path.join(dest, "package.json"),
+    JSON.stringify(packageJson, null, 2)
+  );
+  const readMe = await getReadme(dest, projectName);
+  await fs2.writeFile(path.join(dest, "README.md"), readMe);
+  if (installDeps) {
+    try {
+      await autoInstall(options.packageManager, dest);
+      log("Installed dependencies");
+    } catch (err) {
+      log(`Failed to install dependencies: ${err}`);
+    }
+  }
+  if (initializeGit && await tryGitInit(dest)) {
+    log("Initialized Git repository");
+  }
+}
+async function getReadme(dest, projectName) {
+  const template = await fs2.readFile(path.join(dest, "README.md")).then((res) => res.toString());
+  return `# ${projectName}
+
+${template}`;
+}
+async function copy(from, to, rename = (s) => s) {
+  const stats = await fs2.stat(from);
+  if (stats.isDirectory()) {
+    const files = await fs2.readdir(from);
+    await Promise.all(
+      files.map(
+        (file) => copy(path.join(from, file), rename(path.join(to, file)))
+      )
+    );
+  } else {
+    await fs2.mkdir(path.dirname(to), { recursive: true });
+    await fs2.copyFile(from, to);
+  }
+}
+async function createPackageJson(projectName, dir, options) {
+  function replaceWorkspaceDeps(deps) {
+    for (const k in deps) {
+      if (deps[k].startsWith("workspace:") && k in versions) {
+        deps[k] = versions[k];
+      }
+    }
+    return deps;
+  }
+  if (options.template === "tanstack-start" || options.template === "react-router") {
+    const packageJson = JSON.parse(
+      await fs2.readFile(path.join(dir, "package.json")).then((res) => res.toString())
+    );
+    return {
+      name: projectName,
+      ...packageJson,
+      dependencies: replaceWorkspaceDeps(packageJson.dependencies),
+      devDependencies: replaceWorkspaceDeps(packageJson.devDependencies)
+    };
+  }
+  return {
+    name: projectName,
+    version: "0.0.0",
+    private: true,
+    scripts: {
+      build: "next build",
+      dev: "next dev --turbo",
+      start: "next start",
+      ...options.template === "+next+fuma-docs-mdx" ? {
+        postinstall: "fumadocs-mdx"
+      } : null
+    },
+    dependencies: {
+      ...pick(package_default.dependencies, ["next", "react", "react-dom"]),
+      ...pick(versions, ["fumadocs-ui", "fumadocs-core"]),
+      ...options.template === "+next+content-collections" ? {
+        ...pick(package_default.dependencies, [
+          "@content-collections/mdx",
+          "@content-collections/core",
+          "@content-collections/next"
+        ]),
+        ...pick(versions, ["@fumadocs/content-collections"])
+      } : null,
+      ...options.template === "+next+fuma-docs-mdx" ? pick(versions, ["fumadocs-mdx"]) : null
+    },
+    devDependencies: {
+      ...pick(package_default.dependencies, [
+        "@types/node",
+        "@types/react",
+        "@types/react-dom",
+        "typescript",
+        "@types/mdx"
+      ]),
+      ...options.tailwindcss ? pick(package_default.dependencies, [
+        "@tailwindcss/postcss",
+        "tailwindcss",
+        "postcss"
+      ]) : null,
+      ...options.eslint ? {
+        eslint: "^8",
+        "eslint-config-next": package_default.dependencies.next
+      } : null
+    }
+  };
+}
+function pick(obj, keys) {
+  const result = {};
+  for (const key of keys) {
+    if (key in obj) {
+      result[key] = obj[key];
+    }
+  }
+  return result;
+}
+
+export {
+  managers,
+  getPackageManager,
+  cwd,
+  templates,
+  create
+};

package/dist/create-app.d.ts

@@ -1,6 +1,8 @@
-type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun';
+type PackageManager = (typeof managers)[number];
+declare const managers: readonly ["npm", "yarn", "bun", "pnpm"];
 
-type Template = '+next+content-collections' | '+next+fuma-docs-mdx' | 'react-router' | 'tanstack-start';
+declare const templates: readonly ["+next+content-collections", "+next+fuma-docs-mdx", "react-router", "tanstack-start"];
+type Template = (typeof templates)[number];
 interface Options {
     outputDir: string;
     template: Template;
@@ -32,4 +34,4 @@ interface Options {
 }
 declare function create(options: Options): Promise<void>;
 
-export { type Options, type Template, create };
+export { type Options, type Template, create, templates };

package/dist/create-app.js

@@ -1,6 +1,8 @@
 import {
-  create
-} from "./chunk-FAFA6275.js";
+  create,
+  templates
+} from "./chunk-J4NXLHNR.js";
 export {
-  create
+  create,
+  templates
 };

package/dist/index.js

@@ -2,8 +2,10 @@
 import {
   create,
   cwd,
-  getPackageManager
-} from "./chunk-FAFA6275.js";
+  getPackageManager,
+  managers,
+  templates
+} from "./chunk-J4NXLHNR.js";
 
 // src/index.ts
 import fs from "fs/promises";
@@ -20,42 +22,77 @@ import {
   text
 } from "@clack/prompts";
 import pc from "picocolors";
-var manager = getPackageManager();
-async function main() {
+import { program } from "commander";
+program.argument("[name]", "the project name");
+program.option("--src", "(Next.js only) enable `src/` directory");
+program.option("--no-src", "(Next.js only) disable `src/` directory");
+program.option("--eslint", "(Next.js only) enable ESLint configuration");
+program.option("--no-eslint", "(Next.js only) disable ESLint configuration");
+program.option("--install", "Enable installing packages automatically");
+program.option("--no-install", "Disable installing packages automatically");
+program.option(
+  "--template <name>",
+  `template to choose: ${templates.join(", ")}`,
+  (value) => {
+    if (!templates.includes(value)) {
+      throw new Error(`Invalid template: ${value}.`);
+    }
+    return value;
+  }
+);
+program.option(
+  "--pm <name>",
+  `package manager to choose: ${managers.join(", ")}`,
+  (value) => {
+    if (!managers.includes(value)) {
+      throw new Error(`Invalid package manager: ${value}.`);
+    }
+    return value;
+  }
+);
+async function main(config) {
   intro(pc.bgCyan(pc.bold("Create Fumadocs App")));
+  const manager = config.pm ?? getPackageManager();
   const options = await group(
     {
-      name: () => text({
-        message: "Project name",
-        placeholder: "my-app",
-        defaultValue: "my-app"
-      }),
-      template: () => select({
-        message: "Choose a template",
-        initialValue: "+next+fuma-docs-mdx",
-        options: [
-          {
-            value: "+next+fuma-docs-mdx",
-            label: "Next.js: Fumadocs MDX",
-            hint: "recommended"
-          },
-          {
-            value: "+next+content-collections",
-            label: "Next.js: Content Collections"
-          },
-          {
-            value: "react-router",
-            label: "React Router: MDX Remote"
-          },
-          {
-            value: "tanstack-start",
-            label: "Tanstack Start: MDX Remote",
-            hint: "Experimental"
-          }
-        ]
-      }),
+      name: () => {
+        if (config.name) return Promise.resolve(config.name);
+        return text({
+          message: "Project name",
+          placeholder: "my-app",
+          defaultValue: "my-app"
+        });
+      },
+      template: () => {
+        if (config.template) return Promise.resolve(config.template);
+        return select({
+          message: "Choose a template",
+          initialValue: "+next+fuma-docs-mdx",
+          options: [
+            {
+              value: "+next+fuma-docs-mdx",
+              label: "Next.js: Fumadocs MDX",
+              hint: "recommended"
+            },
+            {
+              value: "+next+content-collections",
+              label: "Next.js: Content Collections"
+            },
+            {
+              value: "react-router",
+              label: "React Router: MDX Remote"
+            },
+            {
+              value: "tanstack-start",
+              label: "Tanstack Start: MDX Remote",
+              hint: "Experimental"
+            }
+          ]
+        });
+      },
       src: (v) => {
         if (!v.results.template?.startsWith("+next")) return;
+        if (config.src !== void 0) return Promise.resolve(config.src);
         return confirm({
           message: "Use `/src` directory?",
           initialValue: false
@@ -63,14 +100,19 @@ async function main() {
       },
       eslint: (v) => {
         if (!v.results.template?.startsWith("+next")) return;
+        if (config.eslint !== void 0) return Promise.resolve(config.eslint);
         return confirm({
           message: "Add default ESLint configuration?",
           initialValue: false
         });
       },
-      installDeps: () => confirm({
-        message: `Do you want to install packages automatically? (detected as ${manager})`
-      })
+      installDeps: () => {
+        if (config.install !== void 0)
+          return Promise.resolve(config.install);
+        return confirm({
+          message: `Do you want to install packages automatically? (detected as ${manager})`
+        });
+      }
     },
     {
       onCancel: () => {
@@ -129,7 +171,11 @@ async function main() {
   );
   process.exit(0);
 }
-main().catch((e) => {
+program.parse();
+main({
+  name: program.args[0],
+  ...program.opts()
+}).catch((e) => {
   console.error(e);
-  throw e;
+  process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-fumadocs-app",
-  "version": "15.6.3",
+  "version": "15.6.5",
   "description": "Create a new documentation site with Fumadocs",
   "keywords": [
     "NextJs",
@@ -22,12 +22,13 @@
   ],
   "dependencies": {
     "@clack/prompts": "^0.11.0",
-    "cross-spawn": "^7.0.6",
-    "picocolors": "^1.1.1"
+    "commander": "^14.0.0",
+    "picocolors": "^1.1.1",
+    "tinyexec": "^1.0.1"
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",
-    "@types/node": "24.0.7",
+    "@types/node": "24.0.15",
     "tinyglobby": "^0.2.14",
     "eslint-config-custom": "0.0.0",
     "tsconfig": "0.0.0"

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

@@ -13,12 +13,6 @@ import type { PageTree } from 'fumadocs-core/server';
 import { createCompiler } from '@fumadocs/mdx-remote';
 import * as path from 'node:path';
 
-export function meta({}: Route.MetaArgs) {
-  return [
-    { title: 'New React Router App' },
-    { name: 'description', content: 'Welcome to React Router!' },
-  ];
-}
 const compiler = createCompiler({
   development: false,
 });
@@ -26,10 +20,10 @@ const compiler = createCompiler({
 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 Error('Not found');
+  if (!page) throw new Response('Not found', { status: 404 });
 
   const compiled = await compiler.compileFile({
-    path: path.resolve('content/docs', page.file.path),
+    path: path.resolve('content/docs', page.path),
     value: page.data.content,
   });
 
@@ -51,6 +45,8 @@ 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>

package/template/react-router/app/routes/home.tsx

@@ -12,14 +12,13 @@ export function meta({}: Route.MetaArgs) {
 export default function Home() {
   return (
     <HomeLayout
-      className="text-center"
       nav={{
         title: 'React Router',
       }}
     >
-      <div className="py-12">
+      <div className="p-4 flex flex-col items-center justify-center text-center flex-1">
         <h1 className="text-xl font-bold mb-2">Fumadocs on React Router.</h1>
-        <p className="text-fd-muted-foreground mb-8">
+        <p className="text-fd-muted-foreground mb-4">
           The truly flexible docs framework on React.js.
         </p>
         <Link

package/template/react-router/content/docs/test.mdx

@@ -1,8 +1,24 @@
 ---
-title: Fumadocs
-description: You can just be minimal.
+title: Test
+description: A document to test Fumadocs
 ---
 
-## Overview
+Hey there!
 
-Fumadocs is a docs framework.
+## Cards
+
+<Cards>
+  <Card title="Learn more about Next.js" href="https://nextjs.org/docs" />
+  <Card title="Learn more about Fumadocs" href="https://fumadocs.vercel.app" />
+</Cards>
+
+### CodeBlock
+
+```js
+console.log('Hello World');
+```
+
+#### List
+
+- Hello
+- World

package/template/react-router/package.json

@@ -0,0 +1,35 @@
+{
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "react-router build",
+    "dev": "react-router dev",
+    "start": "react-router-serve ./build/server/index.js",
+    "typecheck": "react-router typegen && tsc"
+  },
+  "dependencies": {
+    "@fumadocs/mdx-remote": "workspace:*",
+    "@react-router/node": "^7.6.3",
+    "@react-router/serve": "^7.6.3",
+    "fumadocs-core": "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"
+  },
+  "devDependencies": {
+    "@react-router/dev": "^7.6.3",
+    "@tailwindcss/vite": "^4.1.11",
+    "@types/node": "^24.0.13",
+    "@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-tsconfig-paths": "^5.1.4"
+  }
+}

package/template/tanstack-start/content/{docs/index.mdx → index.mdx}

@@ -1,8 +1,7 @@
 ---
 title: Hello World
-description: |
-  Your first `document`
-  You'll love it!
+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?

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

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