create-fumadocs-app 16.0.1 → 16.0.3

package/dist/chunk-3VWJJEHU.js

@@ -0,0 +1,204 @@
+import {
+  copy,
+  cwd,
+  depVersions,
+  pick,
+  sourceDir,
+  templates,
+  tryGitInit
+} from "./chunk-HLHY7KAF.js";
+
+// src/create-app.ts
+import path from "path";
+import fs from "fs/promises";
+
+// src/auto-install.ts
+import { x } 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 x(manager, ["install"], {
+    throwOnError: true,
+    nodeOptions: {
+      env: {
+        ...process.env,
+        NODE_ENV: "development",
+        DISABLE_OPENCOLLECTIVE: "1"
+      },
+      cwd: dest
+    }
+  });
+}
+
+// src/create-app.ts
+function defaults(options) {
+  return {
+    ...options,
+    plugins: options.plugins ?? [],
+    useSrcDir: options.template.startsWith("+next") && options.useSrcDir === true,
+    lint: options.lint ?? false,
+    initializeGit: options.initializeGit ?? false,
+    installDeps: options.installDeps ?? false,
+    log: console.log
+  };
+}
+function isRelative(dir, file) {
+  return !path.relative(dir, file).startsWith(`..${path.sep}`);
+}
+async function create(createOptions) {
+  const options = defaults(createOptions);
+  const {
+    outputDir,
+    useSrcDir,
+    log,
+    installDeps,
+    template,
+    lint,
+    initializeGit,
+    packageManager,
+    plugins
+  } = options;
+  const projectName = path.basename(outputDir);
+  const dest = path.resolve(cwd, outputDir);
+  const isNext = options.template.startsWith("+next");
+  const pluginContext = {
+    template: templates.find((item) => item.value === template),
+    dest,
+    options
+  };
+  await copy(path.join(sourceDir, `template/${template}`), dest, {
+    rename(file) {
+      file = file.replace("example.gitignore", ".gitignore");
+      if (useSrcDir && (path.basename(file) === "mdx-components.tsx" || isRelative(path.join(dest, "app"), file) || isRelative(path.join(dest, "lib"), file))) {
+        return path.join(dest, "src", path.relative(dest, file));
+      }
+      return file;
+    }
+  });
+  if (isNext && lint) {
+    await copy(path.join(sourceDir, `template/+next+${lint}`), dest);
+    log("Configured Linter");
+  }
+  if (isNext && useSrcDir) {
+    const tsconfigPath = path.join(dest, "tsconfig.json");
+    const content = (await fs.readFile(tsconfigPath)).toString();
+    const config = JSON.parse(content);
+    if (config.compilerOptions?.paths) {
+      Object.assign(config.compilerOptions.paths, {
+        "@/*": ["./src/*"]
+      });
+    }
+    await fs.writeFile(tsconfigPath, JSON.stringify(config, null, 2));
+  }
+  let packageJson = await createPackageJson(projectName, dest, options);
+  for (const plugin of plugins) {
+    const result = await plugin.packageJson?.call(pluginContext, packageJson);
+    if (result) packageJson = result;
+  }
+  await fs.writeFile(
+    path.join(dest, "package.json"),
+    JSON.stringify(packageJson, null, 2)
+  );
+  let readme = await getReadme(dest, projectName);
+  for (const plugin of plugins) {
+    readme = await plugin.readme?.call(pluginContext, readme) ?? readme;
+  }
+  await fs.writeFile(path.join(dest, "README.md"), readme);
+  for (const plugin of plugins) {
+    await plugin.afterWrite?.call(pluginContext);
+  }
+  if (installDeps) {
+    try {
+      await autoInstall(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 fs.readFile(path.join(dest, "README.md")).then((res) => res.toString());
+  return `# ${projectName}
+
+${template}`;
+}
+async function createPackageJson(projectName, dir, { template, lint }) {
+  const isNext = template.startsWith("+next");
+  function replaceWorkspaceDeps(deps) {
+    for (const k in deps) {
+      if (deps[k].startsWith("workspace:") && k in depVersions) {
+        deps[k] = depVersions[k];
+      }
+    }
+    return deps;
+  }
+  let packageJson = JSON.parse(
+    await fs.readFile(path.join(dir, "package.json")).then((res) => res.toString())
+  );
+  packageJson = {
+    name: projectName,
+    ...packageJson,
+    dependencies: replaceWorkspaceDeps(packageJson.dependencies),
+    devDependencies: replaceWorkspaceDeps(packageJson.devDependencies)
+  };
+  if (isNext) {
+    packageJson = {
+      ...packageJson,
+      scripts: {
+        ...packageJson.scripts,
+        postinstall: "fumadocs-mdx"
+      }
+    };
+  }
+  if (isNext && lint === "biome") {
+    packageJson = {
+      ...packageJson,
+      scripts: {
+        ...packageJson.scripts,
+        lint: "biome check",
+        format: "biome format --write"
+      },
+      devDependencies: {
+        ...packageJson.devDependencies,
+        ...pick(depVersions, ["@biomejs/biome"])
+      }
+    };
+  }
+  if (isNext && lint === "eslint") {
+    packageJson = {
+      ...packageJson,
+      scripts: {
+        ...packageJson.scripts,
+        lint: "eslint"
+      },
+      devDependencies: {
+        ...packageJson.devDependencies,
+        eslint: "^9",
+        "eslint-config-next": depVersions.next,
+        "@eslint/eslintrc": "^3"
+      }
+    };
+  }
+  return packageJson;
+}
+
+export {
+  managers,
+  getPackageManager,
+  create
+};

package/dist/chunk-HLHY7KAF.js

@@ -0,0 +1,181 @@
+// src/utils.ts
+import fs from "fs/promises";
+import path, { join } from "path";
+import { x } from "tinyexec";
+async function writeFile(file, content) {
+  await fs.mkdir(path.dirname(file), { recursive: true });
+  await fs.writeFile(file, content);
+}
+async function copy(from, to, options = {}) {
+  const {
+    rename = (s) => s,
+    filterDir = () => true,
+    filter = () => true
+  } = options;
+  const stats = await fs.stat(from);
+  if (stats.isDirectory() && filterDir(from)) {
+    const files = await fs.readdir(from);
+    await Promise.all(
+      files.map(
+        (file) => copy(path.join(from, file), path.join(to, file), options)
+      )
+    );
+  }
+  if (stats.isFile() && filter(from)) {
+    to = rename(to);
+    await fs.mkdir(path.dirname(to), { recursive: true });
+    await fs.copyFile(from, to);
+  }
+}
+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;
+  }
+}
+function pick(obj, keys) {
+  const result = {};
+  for (const key of keys) {
+    if (key in obj) {
+      result[key] = obj[key];
+    }
+  }
+  return result;
+}
+
+// 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",
+  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",
+    "@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"
+  }
+};
+
+// src/constants.ts
+var sourceDir = fileURLToPath(new URL(`../`, import.meta.url).href);
+var cwd = process.cwd();
+var templates = [
+  {
+    value: "+next+fuma-docs-mdx",
+    label: "Next.js: Fumadocs MDX",
+    hint: "recommended"
+  },
+  {
+    value: "waku",
+    label: "Waku: Fumadocs MDX"
+  },
+  {
+    value: "react-router",
+    label: "React Router: Fumadocs MDX (not RSC)"
+  },
+  {
+    value: "react-router-spa",
+    label: "React Router SPA: Fumadocs MDX (not RSC)",
+    hint: "SPA mode allows you to host the site statically, compatible with a CDN."
+  },
+  {
+    value: "tanstack-start",
+    label: "Tanstack Start: Fumadocs MDX (not RSC)"
+  }
+];
+var depVersions = {
+  ...versions,
+  ...package_default.dependencies
+};
+
+export {
+  writeFile,
+  copy,
+  tryGitInit,
+  pick,
+  sourceDir,
+  cwd,
+  templates,
+  depVersions
+};

package/dist/create-app.d.ts

@@ -1,8 +1,13 @@
 type PackageManager = (typeof managers)[number];
 declare const managers: readonly ["npm", "yarn", "bun", "pnpm"];
 
-declare const templates: readonly ["+next+content-collections", "+next+fuma-docs-mdx", "react-router", "tanstack-start", "waku"];
-type Template = (typeof templates)[number];
+interface TemplateInfo {
+    value: '+next+fuma-docs-mdx' | 'waku' | 'react-router' | 'react-router-spa' | 'tanstack-start';
+    label: string;
+    hint?: string;
+}
+
+type Template = TemplateInfo['value'];
 interface Options {
     outputDir: string;
     template: Template;
@@ -15,11 +20,6 @@ interface Options {
      * @defaultValue false
      */
     useSrcDir?: boolean;
-    /**
-     * (Next.js only) Configure Tailwind CSS
-     * @defaultValue true
-     */
-    tailwindcss?: boolean;
     /**
      * (Next.js Only) Configure Lint
      * @defaultValue false
@@ -28,7 +28,22 @@ interface Options {
     installDeps?: boolean;
     initializeGit?: boolean;
     log?: (message: string) => void;
+    plugins?: TemplatePlugin[];
+}
+interface TemplatePluginContext {
+    template: TemplateInfo;
+    options: Required<Options>;
+    /**
+     * output directory
+     */
+    dest: string;
+}
+type Awaitable<T> = T | Promise<T>;
+interface TemplatePlugin {
+    packageJson?: (this: TemplatePluginContext, packageJson: any) => Awaitable<void | any>;
+    afterWrite?: (this: TemplatePluginContext) => Awaitable<void>;
+    readme?: (this: TemplatePluginContext, content: string) => Awaitable<void | string>;
 }
 declare function create(createOptions: Options): Promise<void>;
 
-export { type Options, type Template, create, templates };
+export { type Options, type Template, type TemplatePlugin, type TemplatePluginContext, create };

package/dist/create-app.js

@@ -1,8 +1,7 @@
 import {
-  create,
-  templates
-} from "./chunk-YVEWA65C.js";
+  create
+} from "./chunk-3VWJJEHU.js";
+import "./chunk-HLHY7KAF.js";
 export {
-  create,
-  templates
+  create
 };

package/dist/index.js

@@ -1,11 +1,13 @@
 #!/usr/bin/env node
 import {
   create,
-  cwd,
   getPackageManager,
-  managers,
+  managers
+} from "./chunk-3VWJJEHU.js";
+import {
+  cwd,
   templates
-} from "./chunk-YVEWA65C.js";
+} from "./chunk-HLHY7KAF.js";
 
 // src/index.ts
 import fs from "fs/promises";
@@ -35,9 +37,9 @@ program.option("--no-install", "Disable installing packages automatically");
 program.option("--no-git", "Disable auto Git repository initialization");
 program.option(
   "--template <name>",
-  `template to choose: ${templates.join(", ")}`,
+  `template to choose: ${templates.map((v) => v.value).join(", ")}`,
   (value) => {
-    if (!templates.includes(value)) {
+    if (!templates.some((item) => item.value === value)) {
       throw new Error(`Invalid template: ${value}.`);
     }
     return value;
@@ -71,29 +73,7 @@ async function main(config) {
         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: "waku",
-              label: "Waku: Fumadocs MDX"
-            },
-            {
-              value: "react-router",
-              label: "React Router: Fumadocs MDX (not RSC)"
-            },
-            {
-              value: "tanstack-start",
-              label: "Tanstack Start: Fumadocs MDX (not RSC)"
-            }
-          ]
+          options: templates
         });
       },
       src: async (v) => {
@@ -116,6 +96,10 @@ async function main(config) {
           message: "Configure linter?",
           initialValue: false,
           options: [
+            {
+              value: false,
+              label: "Disabled"
+            },
             {
               value: "eslint",
               label: "ESLint"
@@ -123,10 +107,23 @@ async function main(config) {
             {
               value: "biome",
               label: "Biome"
+            }
+          ]
+        });
+      },
+      search: () => {
+        return select({
+          message: "Choose a search solution?",
+          options: [
+            {
+              value: "orama",
+              label: "Default",
+              hint: "local search powered by Orama, recommended"
             },
             {
-              value: false,
-              label: "Disabled"
+              value: "orama-cloud",
+              label: "Orama Cloud",
+              hint: "3rd party search solution, signup needed"
             }
           ]
         });
@@ -173,15 +170,20 @@ async function main(config) {
   }
   const info = spinner();
   info.start(`Generating Project`);
+  const plugins = [];
+  if (options.search === "orama-cloud") {
+    const { oramaCloud } = await import("./orama-cloud-VQUOOEZ2.js");
+    plugins.push(oramaCloud());
+  }
   await create({
     packageManager: manager,
-    tailwindcss: true,
     template: options.template,
     outputDir: dest,
     installDeps: options.installDeps,
     lint: options.lint,
     useSrcDir: options.src,
     initializeGit: config.git ?? true,
+    plugins,
     log: (message) => {
       info.message(message);
     }