create-fumadocs-app 16.1.6 → 16.1.7

package/dist/bin.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { i as templates, n as isCI } from "./constants-UZ9hhOMa.js";
-import { n as getPackageManager, r as managers, t as create } from "./src-Dfp3MdVo.js";
+import { i as templates, n as isCI } from "./constants-wo9ZGmhE.js";
+import { n as getPackageManager, r as managers, t as create } from "./src-Dc0yUG4x.js";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { cancel, confirm, group, intro, isCancel, outro, select, spinner, text } from "@clack/prompts";

package/dist/{constants-UZ9hhOMa.js → constants-wo9ZGmhE.js}

@@ -47,7 +47,7 @@ var package_exports$2 = /* @__PURE__ */ __exportAll({
 	version: () => version$2
 });
 var name$2 = "fumadocs-core";
-var version$2 = "16.12.0";
+var version$2 = "16.12.1";
 var description$2 = "The React.js library for building a documentation website";
 var keywords$2 = ["Docs", "Fumadocs"];
 var homepage$2 = "https://fumadocs.dev";
@@ -449,7 +449,7 @@ var package_exports = /* @__PURE__ */ __exportAll({
 	version: () => version
 });
 var name = "@fumadocs/base-ui";
-var version = "16.12.0";
+var version = "16.12.1";
 var description = "The Base UI version of Fumadocs UI";
 var keywords = ["Docs", "Fumadocs"];
 var homepage = "https://fumadocs.dev";
@@ -649,16 +649,16 @@ const templates = [
 	{
 		value: "+next+fuma-docs-mdx",
 		label: "Next.js: Fumadocs MDX",
-		hint: "recommended",
+		hint: "recommended: powerful and mature",
 		appDir: "",
 		rootProviderPath: "app/layout.tsx"
 	},
 	{
-		value: "astro",
-		label: "Astro: React Islands",
-		hint: "uses Astro Content Collections and Fumadocs UI as a React island",
+		value: "waku",
+		label: "Waku: Fumadocs MDX",
+		hint: "recommended: fast and simple",
 		appDir: "src",
-		rootProviderPath: "components/docs.tsx"
+		rootProviderPath: "components/provider.tsx"
 	},
 	{
 		value: "+next+fuma-docs-mdx+static",
@@ -666,12 +666,6 @@ const templates = [
 		appDir: "",
 		rootProviderPath: "components/provider.tsx"
 	},
-	{
-		value: "waku",
-		label: "Waku: Fumadocs MDX",
-		appDir: "src",
-		rootProviderPath: "components/provider.tsx"
-	},
 	{
 		value: "react-router",
 		label: "React Router: Fumadocs MDX (not RSC)",
@@ -697,6 +691,13 @@ const templates = [
 		hint: "SPA mode allows you to host the site statically, compatible with a CDN.",
 		appDir: "src",
 		rootProviderPath: "routes/__root.tsx"
+	},
+	{
+		value: "astro",
+		label: "Astro: React Islands",
+		hint: "partial support only, uses Astro Content Collections.",
+		appDir: "src",
+		rootProviderPath: "components/docs.tsx"
 	}
 ];
 const workspaces = [
@@ -710,4 +711,4 @@ depVersions["fumadocs-ui"] = `npm:${name}@${version}`;
 //#endregion
 export { templates as i, isCI as n, sourceDir as r, depVersions as t };
 
-//# sourceMappingURL=constants-UZ9hhOMa.js.map
+//# sourceMappingURL=constants-wo9ZGmhE.js.map

package/dist/constants-wo9ZGmhE.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants-wo9ZGmhE.js","names":["corePkg","mdxPkg","basePkg","versionPkg.dependencies","basePkg.name","basePkg.version"],"sources":["../../create-app-versions/package.json","../../core/package.json","../../mdx/package.json","../../base-ui/package.json","../src/constants.ts"],"sourcesContent":["","","","","import { fileURLToPath } from 'node:url';\nimport versionPkg from '../../create-app-versions/package.json';\nimport * as corePkg from '../../core/package.json';\nimport * as mdxPkg from '../../mdx/package.json';\nimport * as basePkg from '../../base-ui/package.json';\n\nexport const sourceDir = fileURLToPath(new URL(`../`, import.meta.url).href);\n\nexport const isCI = Boolean(process.env.CI);\n\nexport interface TemplateInfo {\n  value:\n    | '+next+fuma-docs-mdx'\n    | 'astro'\n    | 'waku'\n    | 'react-router'\n    | 'react-router-spa'\n    | 'tanstack-start'\n    | 'tanstack-start-spa'\n    | '+next+fuma-docs-mdx+static';\n  label: string;\n  appDir: string;\n  /**\n   * path to root provider, relative to `appDir``\n   */\n  rootProviderPath: string;\n  hint?: string;\n  /**\n   * rename files when copying from template\n   */\n  rename?: (name: string) => string;\n}\n\nexport const templates: TemplateInfo[] = [\n  {\n    value: '+next+fuma-docs-mdx',\n    label: 'Next.js: Fumadocs MDX',\n    hint: 'recommended: powerful and mature',\n    appDir: '',\n    rootProviderPath: 'app/layout.tsx',\n  },\n  {\n    value: 'waku',\n    label: 'Waku: Fumadocs MDX',\n    hint: 'recommended: fast and simple',\n    appDir: 'src',\n    rootProviderPath: 'components/provider.tsx',\n  },\n  {\n    value: '+next+fuma-docs-mdx+static',\n    label: 'Next.js Static: Fumadocs MDX',\n    appDir: '',\n    rootProviderPath: 'components/provider.tsx',\n  },\n  {\n    value: 'react-router',\n    label: 'React Router: Fumadocs MDX (not RSC)',\n    appDir: 'app',\n    rootProviderPath: 'root.tsx',\n  },\n  {\n    value: 'react-router-spa',\n    label: 'React Router SPA: Fumadocs MDX (not RSC)',\n    hint: 'SPA mode allows you to host the site statically, compatible with a CDN.',\n    appDir: 'app',\n    rootProviderPath: 'root.tsx',\n  },\n  {\n    value: 'tanstack-start',\n    label: 'Tanstack Start: Fumadocs MDX (not RSC)',\n    appDir: 'src',\n    rootProviderPath: 'routes/__root.tsx',\n  },\n  {\n    value: 'tanstack-start-spa',\n    label: 'Tanstack Start SPA: Fumadocs MDX (not RSC)',\n    hint: 'SPA mode allows you to host the site statically, compatible with a CDN.',\n    appDir: 'src',\n    rootProviderPath: 'routes/__root.tsx',\n  },\n  {\n    value: 'astro',\n    label: 'Astro: React Islands',\n    hint: 'partial support only, uses Astro Content Collections.',\n    appDir: 'src',\n    rootProviderPath: 'components/docs.tsx',\n  },\n];\n\nconst workspaces = [corePkg, mdxPkg, basePkg];\n\nexport const depVersions = versionPkg.dependencies;\n\nfor (const workspace of workspaces) {\n  depVersions[workspace.name as keyof typeof depVersions] = workspace.version;\n}\n\ndepVersions['fumadocs-ui'] = `npm:${basePkg.name}@${basePkg.version}`;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AIMA,MAAa,YAAY,cAAc,IAAI,IAAI,OAAO,OAAO,KAAK,GAAG,CAAC,CAAC,IAAI;AAE3E,MAAa,OAAO,QAAQ,QAAQ,IAAI,EAAE;AAyB1C,MAAa,YAA4B;CACvC;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,QAAQ;EACR,kBAAkB;CACpB;CACA;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,QAAQ;EACR,kBAAkB;CACpB;CACA;EACE,OAAO;EACP,OAAO;EACP,QAAQ;EACR,kBAAkB;CACpB;CACA;EACE,OAAO;EACP,OAAO;EACP,QAAQ;EACR,kBAAkB;CACpB;CACA;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,QAAQ;EACR,kBAAkB;CACpB;CACA;EACE,OAAO;EACP,OAAO;EACP,QAAQ;EACR,kBAAkB;CACpB;CACA;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,QAAQ;EACR,kBAAkB;CACpB;CACA;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,QAAQ;EACR,kBAAkB;CACpB;AACF;AAEA,MAAM,aAAa;CAACA;CAASC;CAAQC;AAAO;AAE5C,MAAa,cAAcC;AAE3B,KAAK,MAAM,aAAa,YACtB,YAAY,UAAU,QAAoC,UAAU;AAGtE,YAAY,iBAAiB,OAAOC,KAAa,GAAGC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-import { t as create } from "./src-Dfp3MdVo.js";
+import { t as create } from "./src-Dc0yUG4x.js";
 export { create };

package/dist/plugins/biome.js

@@ -1,4 +1,4 @@
-import { t as depVersions } from "../constants-UZ9hhOMa.js";
+import { t as depVersions } from "../constants-wo9ZGmhE.js";
 import { i as writeFile, n as pick } from "../utils-BZh9vMXJ.js";
 import biome_base_default from "./biome.base.js";
 import biome_next_default from "./biome.next.js";

package/dist/plugins/next-use-takumi.js

@@ -1,4 +1,4 @@
-import { t as depVersions } from "../constants-UZ9hhOMa.js";
+import { t as depVersions } from "../constants-wo9ZGmhE.js";
 import { n as pick } from "../utils-BZh9vMXJ.js";
 import { readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";

package/dist/plugins/orama-cloud.js

@@ -1,4 +1,4 @@
-import { r as sourceDir, t as depVersions } from "../constants-UZ9hhOMa.js";
+import { r as sourceDir, t as depVersions } from "../constants-wo9ZGmhE.js";
 import { i as writeFile$1, n as pick, t as copy } from "../utils-BZh9vMXJ.js";
 import { n as getCodeValue, t as createSourceFile } from "../shared-Bilr6W8M.js";
 import fs from "node:fs/promises";

package/dist/plugins/oxlint.js

@@ -1,4 +1,4 @@
-import { t as depVersions } from "../constants-UZ9hhOMa.js";
+import { t as depVersions } from "../constants-wo9ZGmhE.js";
 import { n as pick } from "../utils-BZh9vMXJ.js";
 import { writeFile } from "node:fs/promises";
 import path from "node:path";

package/dist/{src-Dfp3MdVo.js → src-Dc0yUG4x.js}

@@ -1,4 +1,4 @@
-import { i as templates, r as sourceDir, t as depVersions } from "./constants-UZ9hhOMa.js";
+import { i as templates, r as sourceDir, t as depVersions } from "./constants-wo9ZGmhE.js";
 import { r as tryGitInit, t as copy } from "./utils-BZh9vMXJ.js";
 import fs from "node:fs/promises";
 import path from "node:path";
@@ -86,4 +86,4 @@ async function initPackageJson(projectName, packageJsonPath) {
 //#endregion
 export { getPackageManager as n, managers as r, create as t };
 
-//# sourceMappingURL=src-Dfp3MdVo.js.map
+//# sourceMappingURL=src-Dc0yUG4x.js.map

package/dist/{src-Dfp3MdVo.js.map → src-Dc0yUG4x.js.map}

@@ -1 +1 @@
-{"version":3,"file":"src-Dfp3MdVo.js","names":[],"sources":["../src/auto-install.ts","../src/index.ts"],"sourcesContent":["import { x } from 'tinyexec';\n\nexport type PackageManager = (typeof managers)[number];\n\nexport const managers = ['npm', 'yarn', 'bun', 'pnpm'] as const;\n\nexport function getPackageManager(): PackageManager {\n  const userAgent = process.env.npm_config_user_agent ?? '';\n\n  if (userAgent.startsWith('yarn')) {\n    return 'yarn';\n  }\n\n  if (userAgent.startsWith('pnpm')) {\n    return 'pnpm';\n  }\n\n  if (userAgent.startsWith('bun')) {\n    return 'bun';\n  }\n\n  return 'npm';\n}\n\nexport async function autoInstall(manager: PackageManager, dest: string) {\n  await x(manager, ['install'], {\n    throwOnError: true,\n    nodeOptions: {\n      env: {\n        ...process.env,\n        NODE_ENV: 'development',\n        DISABLE_OPENCOLLECTIVE: '1',\n      },\n      cwd: dest,\n    },\n  });\n}\n","import path from 'node:path';\nimport fs from 'node:fs/promises';\nimport { copy, tryGitInit } from '@/utils';\nimport type { PackageManager } from './auto-install';\nimport { autoInstall } from './auto-install';\nimport { depVersions, sourceDir, type TemplateInfo, templates } from './constants';\n\nexport type Template = TemplateInfo['value'];\nexport interface Options {\n  outputDir: string;\n  template: Template;\n\n  /**\n   * the package manager to use\n   *\n   * @defaultValue 'npm'\n   */\n  packageManager?: PackageManager;\n\n  installDeps?: boolean;\n  initializeGit?: boolean;\n  log?: (message: string) => void;\n  plugins?: TemplatePlugin[];\n}\n\nexport interface TemplatePluginContext {\n  template: TemplateInfo;\n  log: (message: string) => void;\n  /**\n   * output directory\n   */\n  dest: string;\n\n  /**\n   * output directory for app code (e.g. under `/src`)\n   */\n  appDir: string;\n}\n\nexport type PackageJsonType = {\n  name?: string;\n  version?: string;\n  private?: boolean;\n  scripts?: Record<string, string>;\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n} & Record<string, unknown>;\n\ntype Awaitable<T> = T | Promise<T>;\n\nexport interface TemplatePlugin {\n  template?: (\n    this: Pick<TemplatePluginContext, 'dest'>,\n    info: TemplateInfo,\n  ) => Awaitable<void | TemplateInfo>;\n  packageJson?: (\n    this: TemplatePluginContext,\n    packageJson: PackageJsonType,\n  ) => Awaitable<void | PackageJsonType>;\n  afterWrite?: (this: TemplatePluginContext) => Awaitable<void>;\n  readme?: (this: TemplatePluginContext, content: string) => Awaitable<void | string>;\n}\n\nexport async function create(createOptions: Options): Promise<void> {\n  const {\n    outputDir,\n    plugins = [],\n    packageManager = 'npm',\n    initializeGit = false,\n    installDeps = false,\n    log = console.log,\n  } = createOptions;\n\n  let template = templates.find((item) => item.value === createOptions.template)!;\n  for (const plugin of plugins) {\n    template = (await plugin.template?.call({ dest: outputDir }, template)) ?? template;\n  }\n\n  const appDir = path.join(outputDir, template.appDir);\n  const projectName = path.basename(outputDir);\n  const pluginContext: TemplatePluginContext = {\n    template,\n    dest: outputDir,\n    log,\n    appDir,\n  };\n\n  await copy(path.join(sourceDir, 'template', template.value), outputDir, {\n    rename(file) {\n      file = file.replace('example.gitignore', '.gitignore');\n\n      return template.rename?.(file) ?? file;\n    },\n  });\n\n  const packageJsonPath = path.join(outputDir, 'package.json');\n  let packageJson = await initPackageJson(projectName, packageJsonPath);\n  for (const plugin of plugins) {\n    packageJson = (await plugin.packageJson?.call(pluginContext, packageJson)) ?? packageJson;\n  }\n  await fs.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2));\n\n  const readmePath = path.join(outputDir, 'README.md');\n  let readme = `# ${projectName}\\n\\n${await fs.readFile(readmePath)}`;\n  for (const plugin of plugins) {\n    readme = (await plugin.readme?.call(pluginContext, readme)) ?? readme;\n  }\n  await fs.writeFile(readmePath, readme);\n\n  for (const plugin of plugins) {\n    await plugin.afterWrite?.call(pluginContext);\n  }\n\n  if (installDeps) {\n    try {\n      await autoInstall(packageManager, outputDir);\n      log('Installed dependencies');\n    } catch (err) {\n      log(`Failed to install dependencies: ${err}`);\n    }\n  }\n\n  if (initializeGit && (await tryGitInit(outputDir))) {\n    log('Initialized Git repository');\n  }\n}\n\nasync function initPackageJson(\n  projectName: string,\n  packageJsonPath: string,\n): Promise<PackageJsonType> {\n  function replaceWorkspaceDeps(deps: Record<string, string> = {}) {\n    for (const k in deps) {\n      if (deps[k].startsWith('workspace:') && k in depVersions) {\n        deps[k] = depVersions[k as keyof typeof depVersions];\n      }\n    }\n\n    return deps;\n  }\n\n  const packageJson: PackageJsonType = JSON.parse(await fs.readFile(packageJsonPath, 'utf-8'));\n  const dependencies = replaceWorkspaceDeps(packageJson.dependencies);\n  const devDependencies = replaceWorkspaceDeps(packageJson.devDependencies);\n  const scripts = { ...packageJson.scripts };\n\n  if (dependencies['fumadocs-mdx'] || devDependencies['fumadocs-mdx']) {\n    scripts.postinstall = 'fumadocs-mdx';\n  }\n\n  return {\n    ...packageJson,\n    name: projectName,\n    scripts,\n    dependencies,\n    devDependencies,\n  };\n}\n"],"mappings":";;;;;;AAIA,MAAa,WAAW;CAAC;CAAO;CAAQ;CAAO;AAAM;AAErD,SAAgB,oBAAoC;CAClD,MAAM,YAAY,QAAQ,IAAI,yBAAyB;CAEvD,IAAI,UAAU,WAAW,MAAM,GAC7B,OAAO;CAGT,IAAI,UAAU,WAAW,MAAM,GAC7B,OAAO;CAGT,IAAI,UAAU,WAAW,KAAK,GAC5B,OAAO;CAGT,OAAO;AACT;AAEA,eAAsB,YAAY,SAAyB,MAAc;CACvE,MAAM,EAAE,SAAS,CAAC,SAAS,GAAG;EAC5B,cAAc;EACd,aAAa;GACX,KAAK;IACH,GAAG,QAAQ;IACX,UAAU;IACV,wBAAwB;GAC1B;GACA,KAAK;EACP;CACF,CAAC;AACH;;;AC2BA,eAAsB,OAAO,eAAuC;CAClE,MAAM,EACJ,WACA,UAAU,CAAC,GACX,iBAAiB,OACjB,gBAAgB,OAChB,cAAc,OACd,MAAM,QAAQ,QACZ;CAEJ,IAAI,WAAW,UAAU,MAAM,SAAS,KAAK,UAAU,cAAc,QAAQ;CAC7E,KAAK,MAAM,UAAU,SACnB,WAAY,MAAM,OAAO,UAAU,KAAK,EAAE,MAAM,UAAU,GAAG,QAAQ,KAAM;CAG7E,MAAM,SAAS,KAAK,KAAK,WAAW,SAAS,MAAM;CACnD,MAAM,cAAc,KAAK,SAAS,SAAS;CAC3C,MAAM,gBAAuC;EAC3C;EACA,MAAM;EACN;EACA;CACF;CAEA,MAAM,KAAK,KAAK,KAAK,WAAW,YAAY,SAAS,KAAK,GAAG,WAAW,EACtE,OAAO,MAAM;EACX,OAAO,KAAK,QAAQ,qBAAqB,YAAY;EAErD,OAAO,SAAS,SAAS,IAAI,KAAK;CACpC,EACF,CAAC;CAED,MAAM,kBAAkB,KAAK,KAAK,WAAW,cAAc;CAC3D,IAAI,cAAc,MAAM,gBAAgB,aAAa,eAAe;CACpE,KAAK,MAAM,UAAU,SACnB,cAAe,MAAM,OAAO,aAAa,KAAK,eAAe,WAAW,KAAM;CAEhF,MAAM,GAAG,UAAU,iBAAiB,KAAK,UAAU,aAAa,MAAM,CAAC,CAAC;CAExE,MAAM,aAAa,KAAK,KAAK,WAAW,WAAW;CACnD,IAAI,SAAS,KAAK,YAAY,MAAM,MAAM,GAAG,SAAS,UAAU;CAChE,KAAK,MAAM,UAAU,SACnB,SAAU,MAAM,OAAO,QAAQ,KAAK,eAAe,MAAM,KAAM;CAEjE,MAAM,GAAG,UAAU,YAAY,MAAM;CAErC,KAAK,MAAM,UAAU,SACnB,MAAM,OAAO,YAAY,KAAK,aAAa;CAG7C,IAAI,aACF,IAAI;EACF,MAAM,YAAY,gBAAgB,SAAS;EAC3C,IAAI,wBAAwB;CAC9B,SAAS,KAAK;EACZ,IAAI,mCAAmC,KAAK;CAC9C;CAGF,IAAI,iBAAkB,MAAM,WAAW,SAAS,GAC9C,IAAI,4BAA4B;AAEpC;AAEA,eAAe,gBACb,aACA,iBAC0B;CAC1B,SAAS,qBAAqB,OAA+B,CAAC,GAAG;EAC/D,KAAK,MAAM,KAAK,MACd,IAAI,KAAK,EAAE,CAAC,WAAW,YAAY,KAAK,KAAK,aAC3C,KAAK,KAAK,YAAY;EAI1B,OAAO;CACT;CAEA,MAAM,cAA+B,KAAK,MAAM,MAAM,GAAG,SAAS,iBAAiB,OAAO,CAAC;CAC3F,MAAM,eAAe,qBAAqB,YAAY,YAAY;CAClE,MAAM,kBAAkB,qBAAqB,YAAY,eAAe;CACxE,MAAM,UAAU,EAAE,GAAG,YAAY,QAAQ;CAEzC,IAAI,aAAa,mBAAmB,gBAAgB,iBAClD,QAAQ,cAAc;CAGxB,OAAO;EACL,GAAG;EACH,MAAM;EACN;EACA;EACA;CACF;AACF"}
+{"version":3,"file":"src-Dc0yUG4x.js","names":[],"sources":["../src/auto-install.ts","../src/index.ts"],"sourcesContent":["import { x } from 'tinyexec';\n\nexport type PackageManager = (typeof managers)[number];\n\nexport const managers = ['npm', 'yarn', 'bun', 'pnpm'] as const;\n\nexport function getPackageManager(): PackageManager {\n  const userAgent = process.env.npm_config_user_agent ?? '';\n\n  if (userAgent.startsWith('yarn')) {\n    return 'yarn';\n  }\n\n  if (userAgent.startsWith('pnpm')) {\n    return 'pnpm';\n  }\n\n  if (userAgent.startsWith('bun')) {\n    return 'bun';\n  }\n\n  return 'npm';\n}\n\nexport async function autoInstall(manager: PackageManager, dest: string) {\n  await x(manager, ['install'], {\n    throwOnError: true,\n    nodeOptions: {\n      env: {\n        ...process.env,\n        NODE_ENV: 'development',\n        DISABLE_OPENCOLLECTIVE: '1',\n      },\n      cwd: dest,\n    },\n  });\n}\n","import path from 'node:path';\nimport fs from 'node:fs/promises';\nimport { copy, tryGitInit } from '@/utils';\nimport type { PackageManager } from './auto-install';\nimport { autoInstall } from './auto-install';\nimport { depVersions, sourceDir, type TemplateInfo, templates } from './constants';\n\nexport type Template = TemplateInfo['value'];\nexport interface Options {\n  outputDir: string;\n  template: Template;\n\n  /**\n   * the package manager to use\n   *\n   * @defaultValue 'npm'\n   */\n  packageManager?: PackageManager;\n\n  installDeps?: boolean;\n  initializeGit?: boolean;\n  log?: (message: string) => void;\n  plugins?: TemplatePlugin[];\n}\n\nexport interface TemplatePluginContext {\n  template: TemplateInfo;\n  log: (message: string) => void;\n  /**\n   * output directory\n   */\n  dest: string;\n\n  /**\n   * output directory for app code (e.g. under `/src`)\n   */\n  appDir: string;\n}\n\nexport type PackageJsonType = {\n  name?: string;\n  version?: string;\n  private?: boolean;\n  scripts?: Record<string, string>;\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n} & Record<string, unknown>;\n\ntype Awaitable<T> = T | Promise<T>;\n\nexport interface TemplatePlugin {\n  template?: (\n    this: Pick<TemplatePluginContext, 'dest'>,\n    info: TemplateInfo,\n  ) => Awaitable<void | TemplateInfo>;\n  packageJson?: (\n    this: TemplatePluginContext,\n    packageJson: PackageJsonType,\n  ) => Awaitable<void | PackageJsonType>;\n  afterWrite?: (this: TemplatePluginContext) => Awaitable<void>;\n  readme?: (this: TemplatePluginContext, content: string) => Awaitable<void | string>;\n}\n\nexport async function create(createOptions: Options): Promise<void> {\n  const {\n    outputDir,\n    plugins = [],\n    packageManager = 'npm',\n    initializeGit = false,\n    installDeps = false,\n    log = console.log,\n  } = createOptions;\n\n  let template = templates.find((item) => item.value === createOptions.template)!;\n  for (const plugin of plugins) {\n    template = (await plugin.template?.call({ dest: outputDir }, template)) ?? template;\n  }\n\n  const appDir = path.join(outputDir, template.appDir);\n  const projectName = path.basename(outputDir);\n  const pluginContext: TemplatePluginContext = {\n    template,\n    dest: outputDir,\n    log,\n    appDir,\n  };\n\n  await copy(path.join(sourceDir, 'template', template.value), outputDir, {\n    rename(file) {\n      file = file.replace('example.gitignore', '.gitignore');\n\n      return template.rename?.(file) ?? file;\n    },\n  });\n\n  const packageJsonPath = path.join(outputDir, 'package.json');\n  let packageJson = await initPackageJson(projectName, packageJsonPath);\n  for (const plugin of plugins) {\n    packageJson = (await plugin.packageJson?.call(pluginContext, packageJson)) ?? packageJson;\n  }\n  await fs.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2));\n\n  const readmePath = path.join(outputDir, 'README.md');\n  let readme = `# ${projectName}\\n\\n${await fs.readFile(readmePath)}`;\n  for (const plugin of plugins) {\n    readme = (await plugin.readme?.call(pluginContext, readme)) ?? readme;\n  }\n  await fs.writeFile(readmePath, readme);\n\n  for (const plugin of plugins) {\n    await plugin.afterWrite?.call(pluginContext);\n  }\n\n  if (installDeps) {\n    try {\n      await autoInstall(packageManager, outputDir);\n      log('Installed dependencies');\n    } catch (err) {\n      log(`Failed to install dependencies: ${err}`);\n    }\n  }\n\n  if (initializeGit && (await tryGitInit(outputDir))) {\n    log('Initialized Git repository');\n  }\n}\n\nasync function initPackageJson(\n  projectName: string,\n  packageJsonPath: string,\n): Promise<PackageJsonType> {\n  function replaceWorkspaceDeps(deps: Record<string, string> = {}) {\n    for (const k in deps) {\n      if (deps[k].startsWith('workspace:') && k in depVersions) {\n        deps[k] = depVersions[k as keyof typeof depVersions];\n      }\n    }\n\n    return deps;\n  }\n\n  const packageJson: PackageJsonType = JSON.parse(await fs.readFile(packageJsonPath, 'utf-8'));\n  const dependencies = replaceWorkspaceDeps(packageJson.dependencies);\n  const devDependencies = replaceWorkspaceDeps(packageJson.devDependencies);\n  const scripts = { ...packageJson.scripts };\n\n  if (dependencies['fumadocs-mdx'] || devDependencies['fumadocs-mdx']) {\n    scripts.postinstall = 'fumadocs-mdx';\n  }\n\n  return {\n    ...packageJson,\n    name: projectName,\n    scripts,\n    dependencies,\n    devDependencies,\n  };\n}\n"],"mappings":";;;;;;AAIA,MAAa,WAAW;CAAC;CAAO;CAAQ;CAAO;AAAM;AAErD,SAAgB,oBAAoC;CAClD,MAAM,YAAY,QAAQ,IAAI,yBAAyB;CAEvD,IAAI,UAAU,WAAW,MAAM,GAC7B,OAAO;CAGT,IAAI,UAAU,WAAW,MAAM,GAC7B,OAAO;CAGT,IAAI,UAAU,WAAW,KAAK,GAC5B,OAAO;CAGT,OAAO;AACT;AAEA,eAAsB,YAAY,SAAyB,MAAc;CACvE,MAAM,EAAE,SAAS,CAAC,SAAS,GAAG;EAC5B,cAAc;EACd,aAAa;GACX,KAAK;IACH,GAAG,QAAQ;IACX,UAAU;IACV,wBAAwB;GAC1B;GACA,KAAK;EACP;CACF,CAAC;AACH;;;AC2BA,eAAsB,OAAO,eAAuC;CAClE,MAAM,EACJ,WACA,UAAU,CAAC,GACX,iBAAiB,OACjB,gBAAgB,OAChB,cAAc,OACd,MAAM,QAAQ,QACZ;CAEJ,IAAI,WAAW,UAAU,MAAM,SAAS,KAAK,UAAU,cAAc,QAAQ;CAC7E,KAAK,MAAM,UAAU,SACnB,WAAY,MAAM,OAAO,UAAU,KAAK,EAAE,MAAM,UAAU,GAAG,QAAQ,KAAM;CAG7E,MAAM,SAAS,KAAK,KAAK,WAAW,SAAS,MAAM;CACnD,MAAM,cAAc,KAAK,SAAS,SAAS;CAC3C,MAAM,gBAAuC;EAC3C;EACA,MAAM;EACN;EACA;CACF;CAEA,MAAM,KAAK,KAAK,KAAK,WAAW,YAAY,SAAS,KAAK,GAAG,WAAW,EACtE,OAAO,MAAM;EACX,OAAO,KAAK,QAAQ,qBAAqB,YAAY;EAErD,OAAO,SAAS,SAAS,IAAI,KAAK;CACpC,EACF,CAAC;CAED,MAAM,kBAAkB,KAAK,KAAK,WAAW,cAAc;CAC3D,IAAI,cAAc,MAAM,gBAAgB,aAAa,eAAe;CACpE,KAAK,MAAM,UAAU,SACnB,cAAe,MAAM,OAAO,aAAa,KAAK,eAAe,WAAW,KAAM;CAEhF,MAAM,GAAG,UAAU,iBAAiB,KAAK,UAAU,aAAa,MAAM,CAAC,CAAC;CAExE,MAAM,aAAa,KAAK,KAAK,WAAW,WAAW;CACnD,IAAI,SAAS,KAAK,YAAY,MAAM,MAAM,GAAG,SAAS,UAAU;CAChE,KAAK,MAAM,UAAU,SACnB,SAAU,MAAM,OAAO,QAAQ,KAAK,eAAe,MAAM,KAAM;CAEjE,MAAM,GAAG,UAAU,YAAY,MAAM;CAErC,KAAK,MAAM,UAAU,SACnB,MAAM,OAAO,YAAY,KAAK,aAAa;CAG7C,IAAI,aACF,IAAI;EACF,MAAM,YAAY,gBAAgB,SAAS;EAC3C,IAAI,wBAAwB;CAC9B,SAAS,KAAK;EACZ,IAAI,mCAAmC,KAAK;CAC9C;CAGF,IAAI,iBAAkB,MAAM,WAAW,SAAS,GAC9C,IAAI,4BAA4B;AAEpC;AAEA,eAAe,gBACb,aACA,iBAC0B;CAC1B,SAAS,qBAAqB,OAA+B,CAAC,GAAG;EAC/D,KAAK,MAAM,KAAK,MACd,IAAI,KAAK,EAAE,CAAC,WAAW,YAAY,KAAK,KAAK,aAC3C,KAAK,KAAK,YAAY;EAI1B,OAAO;CACT;CAEA,MAAM,cAA+B,KAAK,MAAM,MAAM,GAAG,SAAS,iBAAiB,OAAO,CAAC;CAC3F,MAAM,eAAe,qBAAqB,YAAY,YAAY;CAClE,MAAM,kBAAkB,qBAAqB,YAAY,eAAe;CACxE,MAAM,UAAU,EAAE,GAAG,YAAY,QAAQ;CAEzC,IAAI,aAAa,mBAAmB,gBAAgB,iBAClD,QAAQ,cAAc;CAGxB,OAAO;EACL,GAAG;EACH,MAAM;EACN;EACA;EACA;CACF;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-fumadocs-app",
-  "version": "16.1.6",
+  "version": "16.1.7",
   "description": "Create a new documentation site with Fumadocs",
   "keywords": [
     "Docs",

package/template/+next+fuma-docs-mdx/app/docs/[[...slug]]/page.tsx

@@ -1,4 +1,4 @@
-import { getPageImage, getPageMarkdownUrl, source } from '@/lib/source';
+import { getPageImageUrl, getPageMarkdownUrl, source } from '@/lib/source';
 import {
   DocsBody,
   DocsDescription,
@@ -57,7 +57,7 @@ export async function generateMetadata(props: PageProps<'/docs/[[...slug]]'>): P
     title: page.data.title,
     description: page.data.description,
     openGraph: {
-      images: getPageImage(page).url,
+      images: getPageImageUrl(page).url,
     },
   };
 }

package/template/+next+fuma-docs-mdx/app/og/docs/[...slug]/route.tsx

@@ -1,4 +1,4 @@
-import { getPageImage, source } from '@/lib/source';
+import { getPageImageUrl, source } from '@/lib/source';
 import { notFound } from 'next/navigation';
 import { ImageResponse } from 'next/og';
 import { generate as DefaultImage } from 'fumadocs-ui/og';
@@ -23,6 +23,6 @@ export async function GET(_req: Request, { params }: RouteContext<'/og/docs/[...
 export function generateStaticParams() {
   return source.getPages().map((page) => ({
     lang: page.locale,
-    slug: getPageImage(page).segments,
+    slug: getPageImageUrl(page).segments,
   }));
 }

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

@@ -10,12 +10,12 @@ export const source = loader({
   plugins: [lucideIconsPlugin()],
 });
 
-export function getPageImage(page: (typeof source)['$inferPage']) {
+export function getPageImageUrl(page: (typeof source)['$inferPage']) {
   const segments = [...page.slugs, 'image.png'];
 
   return {
     segments,
-    url: `${docsImageRoute}/${segments.join('/')}`,
+    url: '/' + [page.locale, ...docsImageRoute.split('/'), ...segments].filter(Boolean).join('/'),
   };
 }
 
@@ -24,7 +24,7 @@ export function getPageMarkdownUrl(page: (typeof source)['$inferPage']) {
 
   return {
     segments,
-    url: `${docsContentRoute}/${segments.join('/')}`,
+    url: '/' + [page.locale, ...docsContentRoute.split('/'), ...segments].filter(Boolean).join('/'),
   };
 }
 

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

@@ -1,6 +1,6 @@
 {
   "name": "example-next",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "private": true,
   "scripts": {
     "build": "next build",

package/template/+next+fuma-docs-mdx+static/app/docs/[[...slug]]/page.tsx

@@ -1,4 +1,4 @@
-import { getPageImage, getPageMarkdownUrl, source } from '@/lib/source';
+import { getPageImageUrl, getPageMarkdownUrl, source } from '@/lib/source';
 import {
   DocsBody,
   DocsDescription,
@@ -57,7 +57,7 @@ export async function generateMetadata(props: PageProps<'/docs/[[...slug]]'>): P
     title: page.data.title,
     description: page.data.description,
     openGraph: {
-      images: getPageImage(page).url,
+      images: getPageImageUrl(page).url,
     },
   };
 }

package/template/+next+fuma-docs-mdx+static/app/og/docs/[...slug]/route.tsx

@@ -1,4 +1,4 @@
-import { getPageImage, source } from '@/lib/source';
+import { getPageImageUrl, source } from '@/lib/source';
 import { notFound } from 'next/navigation';
 import { ImageResponse } from 'next/og';
 import { generate as DefaultImage } from 'fumadocs-ui/og';
@@ -23,6 +23,6 @@ export async function GET(_req: Request, { params }: RouteContext<'/og/docs/[...
 export function generateStaticParams() {
   return source.getPages().map((page) => ({
     lang: page.locale,
-    slug: getPageImage(page).segments,
+    slug: getPageImageUrl(page).segments,
   }));
 }

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

@@ -9,12 +9,12 @@ export const source = loader({
   plugins: [],
 });
 
-export function getPageImage(page: (typeof source)['$inferPage']) {
+export function getPageImageUrl(page: (typeof source)['$inferPage']) {
   const segments = [...page.slugs, 'image.png'];
 
   return {
     segments,
-    url: `${docsImageRoute}/${segments.join('/')}`,
+    url: '/' + [page.locale, ...docsImageRoute.split('/'), ...segments].filter(Boolean).join('/'),
   };
 }
 
@@ -23,7 +23,7 @@ export function getPageMarkdownUrl(page: (typeof source)['$inferPage']) {
 
   return {
     segments,
-    url: `${docsContentRoute}/${segments.join('/')}`,
+    url: '/' + [page.locale, ...docsContentRoute.split('/'), ...segments].filter(Boolean).join('/'),
   };
 }
 

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

@@ -1,6 +1,6 @@
 {
   "name": "example-next-static",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "private": true,
   "scripts": {
     "build": "next build",

package/template/astro/package.json

@@ -1,6 +1,6 @@
 {
   "name": "example-astro",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "private": true,
   "type": "module",
   "scripts": {

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

@@ -13,13 +13,10 @@ export function getStructuredData(entry: CollectionEntry<'docs'>): StructuredDat
   return structure(entry.body);
 }
 
-export function getPageImage(slugs: string[]) {
-  const segments = [...slugs, 'image.webp'];
+export function getPageImageUrl(page: (typeof source)['$inferPage']) {
+  const segments = [...page.slugs, 'image.webp'];
 
-  return {
-    segments,
-    url: `/og/docs/${segments.join('/')}`,
-  };
+  return '/' + [page.locale, 'og', 'docs', ...segments].filter(Boolean).join('/');
 }
 
 async function createMySource() {

package/template/astro/src/pages/[...slug].astro

@@ -3,7 +3,7 @@ import { render, type CollectionEntry } from "astro:content";
 import { Docs } from "@/components/docs";
 import defaultMdxComponents from "fumadocs-ui/mdx";
 import "@/styles/global.css";
-import { getPageImage, source } from "@/lib/source";
+import { getPageImageUrl, source } from "@/lib/source";
 import Layout from "@/components/layout.astro";
 import type { TOCItemType } from "fumadocs-core/toc";
 
@@ -21,7 +21,8 @@ export async function getStaticPaths() {
 const { page } = Astro.props;
 const { Content, headings } = await render(page);
 const slugs = typeof Astro.params.slug === "string" ? Astro.params.slug.split("/") : [];
-const image = getPageImage(slugs).url;
+const docsPage = source.getPage(slugs)!;
+const image = getPageImageUrl(docsPage);
 
 const toc: TOCItemType[] = headings.map((heading) => ({
   depth: heading.depth,

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

@@ -9,3 +9,9 @@ export const gitConfig = {
   repo: 'fumadocs',
   branch: 'main',
 };
+
+export function getPageImagePath(slugs: string[], locale?: string) {
+  return (
+    '/' + [locale, ...docsImageRoute.split('/'), ...slugs, 'image.webp'].filter(Boolean).join('/')
+  );
+}

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

@@ -12,7 +12,7 @@ export function getPageMarkdownUrl(page: (typeof source)['$inferPage']) {
 
   return {
     segments,
-    url: `${docsContentRoute}/${segments.join('/')}`,
+    url: '/' + [page.locale, ...docsContentRoute.split('/'), ...segments].filter(Boolean).join('/'),
   };
 }
 

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

@@ -11,9 +11,8 @@ import {
 import { getPageMarkdownUrl, source } from '@/lib/source';
 import browserCollections from 'collections/browser';
 import { baseOptions } from '@/lib/layout.shared';
-import { gitConfig } from '@/lib/shared';
+import { gitConfig, getPageImagePath } from '@/lib/shared';
 import { useFumadocsLoader } from 'fumadocs-core/source/client';
-import { getPageImagePath } from '@/lib/og';
 import { useMDXComponents } from '@/components/mdx';
 
 export async function loader({ params }: Route.LoaderArgs) {
@@ -25,7 +24,7 @@ export async function loader({ params }: Route.LoaderArgs) {
     path: page.path,
     markdownUrl: getPageMarkdownUrl(page).url,
     pageTree: await source.serializePageTree(source.getPageTree()),
-    imagePath: getPageImagePath(slugs),
+    imagePath: getPageImagePath(page.slugs, page.locale),
   };
 }
 

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

@@ -1,7 +1,7 @@
 import type { Config } from '@react-router/dev/config';
 import { glob } from 'node:fs/promises';
 import { createGetUrl, getSlugs } from 'fumadocs-core/source';
-import { getPageImagePath } from './app/lib/og';
+import { getPageImagePath } from '@/lib/shared';
 
 const getUrl = createGetUrl('/docs');
 

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

@@ -12,7 +12,7 @@ export function getPageMarkdownUrl(page: (typeof source)['$inferPage']) {
 
   return {
     segments,
-    url: `${docsContentRoute}/${segments.join('/')}`,
+    url: '/' + [page.locale, ...docsContentRoute.split('/'), ...segments].filter(Boolean).join('/'),
   };
 }
 

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

@@ -8,3 +8,24 @@ export const gitConfig = {
   repo: 'fumadocs',
   branch: 'main',
 };
+
+export function encodeMarkdownUrl(slugs: string[], locale?: string) {
+  const segments = [...slugs];
+  if (segments.length === 0) {
+    segments.push('index.md');
+  } else {
+    segments[segments.length - 1] += '.md';
+  }
+
+  return '/' + [locale, ...docsRoute.split('/'), ...segments].filter(Boolean).join('/');
+}
+
+/** @returns page slugs */
+export function decodeMarkdownUrl(segments: string[]) {
+  if (segments.length === 0) return [];
+
+  const out = [...segments];
+  out[out.length - 1] = out[out.length - 1].replace(/\.md$/, '');
+  if (out.length === 1 && out[0] === 'index') out.pop();
+  return out;
+}

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

@@ -9,29 +9,6 @@ export const source = loader({
   plugins: [lucideIconsPlugin()],
 });
 
-export function markdownPathToSlugs(segs: string[]) {
-  if (segs.length === 0) return [];
-
-  const out = [...segs];
-  out[out.length - 1] = out[out.length - 1].replace(/\.md$/, '');
-  if (out.length === 1 && out[0] === 'index') out.pop();
-  return out;
-}
-
-export function slugsToMarkdownPath(slugs: string[]) {
-  const segments = [...slugs];
-  if (segments.length === 0) {
-    segments.push('index.md');
-  } else {
-    segments[segments.length - 1] += '.md';
-  }
-
-  return {
-    segments,
-    url: `${docsRoute}/${segments.join('/')}`,
-  };
-}
-
 export async function getLLMText(page: (typeof source)['$inferPage']) {
   const processed = await page.data.getText('processed');
 

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

@@ -1,7 +1,7 @@
 import { createFileRoute, notFound } from '@tanstack/react-router';
 import { DocsLayout } from 'fumadocs-ui/layouts/docs';
 import { createServerFn } from '@tanstack/react-start';
-import { slugsToMarkdownPath, source } from '@/lib/source';
+import { source } from '@/lib/source';
 import browserCollections from 'collections/browser';
 import {
   DocsBody,
@@ -12,7 +12,7 @@ import {
   ViewOptionsPopover,
 } from 'fumadocs-ui/layouts/docs/page';
 import { baseOptions } from '@/lib/layout.shared';
-import { gitConfig } from '@/lib/shared';
+import { encodeMarkdownUrl, gitConfig } from '@/lib/shared';
 import { useFumadocsLoader } from 'fumadocs-core/source/client';
 import { Suspense } from 'react';
 import { useMDXComponents } from '@/components/mdx';
@@ -37,7 +37,7 @@ const serverLoader = createServerFn({
 
     return {
       path: page.path,
-      markdownUrl: slugsToMarkdownPath(page.slugs).url,
+      markdownUrl: encodeMarkdownUrl(page.slugs, page.locale),
       pageTree: await source.serializePageTree(source.getPageTree()),
     };
   });

package/template/tanstack-start/src/routes/docs/{$}[.]md.ts

@@ -1,11 +1,12 @@
 import { createFileRoute, notFound } from '@tanstack/react-router';
-import { getLLMText, markdownPathToSlugs, source } from '@/lib/source';
+import { getLLMText, source } from '@/lib/source';
+import { decodeMarkdownUrl } from '@/lib/shared';
 
 export const Route = createFileRoute('/docs/{$}.md')({
   server: {
     handlers: {
       GET: async ({ params }) => {
-        const slugs = markdownPathToSlugs(params._splat?.split('/') ?? []);
+        const slugs = decodeMarkdownUrl(params._splat?.split('/') ?? []);
         const page = source.getPage(slugs);
         if (!page) throw notFound();
 

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

@@ -1,8 +1,7 @@
 import { createMiddleware, createCsrfMiddleware, createStart } from '@tanstack/react-start';
 import { isMarkdownPreferred } from 'fumadocs-core/negotiation';
 import { redirect } from '@tanstack/react-router';
-import { docsRoute } from '@/lib/shared';
-import { slugsToMarkdownPath } from './lib/source';
+import { docsRoute, encodeMarkdownUrl } from '@/lib/shared';
 
 const csrfMiddleware = createCsrfMiddleware({
   filter: (ctx) => ctx.handlerType === 'serverFn',
@@ -20,7 +19,7 @@ const llmMiddleware = createMiddleware().server(({ next, request }) => {
       .slice(docsRoute.length)
       .split('/')
       .filter((v) => v.length > 0);
-    url.pathname = slugsToMarkdownPath(slugs).url;
+    url.pathname = encodeMarkdownUrl(slugs);
 
     throw redirect(url);
   }

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

@@ -8,3 +8,24 @@ export const gitConfig = {
   repo: 'fumadocs',
   branch: 'main',
 };
+
+export function encodeMarkdownUrl(slugs: string[], locale?: string) {
+  const segments = [...slugs];
+  if (segments.length === 0) {
+    segments.push('index.md');
+  } else {
+    segments[segments.length - 1] += '.md';
+  }
+
+  return '/' + [locale, ...docsRoute.split('/'), ...segments].filter(Boolean).join('/');
+}
+
+/** @returns page slugs */
+export function decodeMarkdownUrl(segments: string[]) {
+  if (segments.length === 0) return [];
+
+  const out = [...segments];
+  out[out.length - 1] = out[out.length - 1].replace(/\.md$/, '');
+  if (out.length === 1 && out[0] === 'index') out.pop();
+  return out;
+}

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

@@ -9,29 +9,6 @@ export const source = loader({
   plugins: [lucideIconsPlugin()],
 });
 
-export function markdownPathToSlugs(segs: string[]) {
-  if (segs.length === 0) return [];
-
-  const out = [...segs];
-  out[out.length - 1] = out[out.length - 1].replace(/\.md$/, '');
-  if (out.length === 1 && out[0] === 'index') out.pop();
-  return out;
-}
-
-export function slugsToMarkdownPath(slugs: string[]) {
-  const segments = [...slugs];
-  if (segments.length === 0) {
-    segments.push('index.md');
-  } else {
-    segments[segments.length - 1] += '.md';
-  }
-
-  return {
-    segments,
-    url: `${docsRoute}/${segments.join('/')}`,
-  };
-}
-
 export async function getLLMText(page: (typeof source)['$inferPage']) {
   const processed = await page.data.getText('processed');
 

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

@@ -1,7 +1,7 @@
 import { createFileRoute, Link, notFound } from '@tanstack/react-router';
 import { DocsLayout } from 'fumadocs-ui/layouts/docs';
 import { createServerFn } from '@tanstack/react-start';
-import { slugsToMarkdownPath, source } from '@/lib/source';
+import { source } from '@/lib/source';
 import browserCollections from 'collections/browser';
 import {
   DocsBody,
@@ -12,7 +12,7 @@ import {
   ViewOptionsPopover,
 } from 'fumadocs-ui/layouts/docs/page';
 import { baseOptions } from '@/lib/layout.shared';
-import { gitConfig } from '@/lib/shared';
+import { encodeMarkdownUrl, gitConfig } from '@/lib/shared';
 import { staticFunctionMiddleware } from '@tanstack/start-static-server-functions';
 import { useFumadocsLoader } from 'fumadocs-core/source/client';
 import { Suspense } from 'react';
@@ -39,7 +39,7 @@ const loader = createServerFn({
 
     return {
       path: page.path,
-      markdownUrl: slugsToMarkdownPath(page.slugs).url,
+      markdownUrl: encodeMarkdownUrl(page.slugs, page.locale),
       pageTree: await source.serializePageTree(source.getPageTree()),
     };
   });

package/template/tanstack-start-spa/src/routes/docs/{$}[.]md.ts

@@ -1,11 +1,12 @@
 import { createFileRoute, notFound } from '@tanstack/react-router';
-import { getLLMText, markdownPathToSlugs, source } from '@/lib/source';
+import { getLLMText, source } from '@/lib/source';
+import { decodeMarkdownUrl } from '@/lib/shared';
 
 export const Route = createFileRoute('/docs/{$}.md')({
   server: {
     handlers: {
       GET: async ({ params }) => {
-        const slugs = markdownPathToSlugs(params._splat?.split('/') ?? []);
+        const slugs = decodeMarkdownUrl(params._splat?.split('/') ?? []);
         const page = source.getPage(slugs);
         if (!page) throw notFound();
 

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

@@ -9,13 +9,10 @@ export const source = loader({
   plugins: [lucideIconsPlugin()],
 });
 
-export function getPageImage(slugs: string[]) {
-  const segments = [...slugs, 'image.webp'];
+export function getPageImageUrl(page: (typeof source)['$inferPage']) {
+  const segments = [...page.slugs, 'image.webp'];
 
-  return {
-    segments,
-    url: `${docsImageRoute}/${segments.join('/')}`,
-  };
+  return '/' + [page.locale, ...docsImageRoute.split('/'), ...segments].filter(Boolean).join('/');
 }
 
 export function getPageMarkdownUrl(page: (typeof source)['$inferPage']) {
@@ -23,7 +20,7 @@ export function getPageMarkdownUrl(page: (typeof source)['$inferPage']) {
 
   return {
     segments,
-    url: `${docsContentRoute}/${segments.join('/')}`,
+    url: '/' + [page.locale, ...docsContentRoute.split('/'), ...segments].filter(Boolean).join('/'),
   };
 }
 

package/template/waku/src/pages/docs/[...slugs].tsx

@@ -1,4 +1,4 @@
-import { getPageImage, getPageMarkdownUrl, source } from '@/lib/source';
+import { getPageImageUrl, getPageMarkdownUrl, source } from '@/lib/source';
 import { PageProps } from 'waku/router';
 import { createRelativeLink } from 'fumadocs-ui/mdx';
 import {
@@ -21,7 +21,7 @@ export default function Page({ slugs }: PageProps<'/docs/[...slugs]'>) {
   const markdownUrl = getPageMarkdownUrl(page).url;
   return (
     <DocsPage toc={page.data.toc}>
-      <meta property="og:image" content={getPageImage(slugs).url} />
+      <meta property="og:image" content={getPageImageUrl(page)} />
       <DocsTitle>{page.data.title}</DocsTitle>
       <DocsDescription className="mb-0">{page.data.description}</DocsDescription>
       <div className="flex flex-row gap-2 items-center border-b pt-2 pb-6">

package/dist/constants-UZ9hhOMa.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants-UZ9hhOMa.js","names":["corePkg","mdxPkg","basePkg","versionPkg.dependencies","basePkg.name","basePkg.version"],"sources":["../../create-app-versions/package.json","../../core/package.json","../../mdx/package.json","../../base-ui/package.json","../src/constants.ts"],"sourcesContent":["","","","","import { fileURLToPath } from 'node:url';\nimport versionPkg from '../../create-app-versions/package.json';\nimport * as corePkg from '../../core/package.json';\nimport * as mdxPkg from '../../mdx/package.json';\nimport * as basePkg from '../../base-ui/package.json';\n\nexport const sourceDir = fileURLToPath(new URL(`../`, import.meta.url).href);\n\nexport const isCI = Boolean(process.env.CI);\n\nexport interface TemplateInfo {\n  value:\n    | '+next+fuma-docs-mdx'\n    | 'astro'\n    | 'waku'\n    | 'react-router'\n    | 'react-router-spa'\n    | 'tanstack-start'\n    | 'tanstack-start-spa'\n    | '+next+fuma-docs-mdx+static';\n  label: string;\n  appDir: string;\n  /**\n   * path to root provider, relative to `appDir``\n   */\n  rootProviderPath: string;\n  hint?: string;\n  /**\n   * rename files when copying from template\n   */\n  rename?: (name: string) => string;\n}\n\nexport const templates: TemplateInfo[] = [\n  {\n    value: '+next+fuma-docs-mdx',\n    label: 'Next.js: Fumadocs MDX',\n    hint: 'recommended',\n    appDir: '',\n    rootProviderPath: 'app/layout.tsx',\n  },\n  {\n    value: 'astro',\n    label: 'Astro: React Islands',\n    hint: 'uses Astro Content Collections and Fumadocs UI as a React island',\n    appDir: 'src',\n    rootProviderPath: 'components/docs.tsx',\n  },\n  {\n    value: '+next+fuma-docs-mdx+static',\n    label: 'Next.js Static: Fumadocs MDX',\n    appDir: '',\n    rootProviderPath: 'components/provider.tsx',\n  },\n  {\n    value: 'waku',\n    label: 'Waku: Fumadocs MDX',\n    appDir: 'src',\n    rootProviderPath: 'components/provider.tsx',\n  },\n  {\n    value: 'react-router',\n    label: 'React Router: Fumadocs MDX (not RSC)',\n    appDir: 'app',\n    rootProviderPath: 'root.tsx',\n  },\n  {\n    value: 'react-router-spa',\n    label: 'React Router SPA: Fumadocs MDX (not RSC)',\n    hint: 'SPA mode allows you to host the site statically, compatible with a CDN.',\n    appDir: 'app',\n    rootProviderPath: 'root.tsx',\n  },\n  {\n    value: 'tanstack-start',\n    label: 'Tanstack Start: Fumadocs MDX (not RSC)',\n    appDir: 'src',\n    rootProviderPath: 'routes/__root.tsx',\n  },\n  {\n    value: 'tanstack-start-spa',\n    label: 'Tanstack Start SPA: Fumadocs MDX (not RSC)',\n    hint: 'SPA mode allows you to host the site statically, compatible with a CDN.',\n    appDir: 'src',\n    rootProviderPath: 'routes/__root.tsx',\n  },\n];\n\nconst workspaces = [corePkg, mdxPkg, basePkg];\n\nexport const depVersions = versionPkg.dependencies;\n\nfor (const workspace of workspaces) {\n  depVersions[workspace.name as keyof typeof depVersions] = workspace.version;\n}\n\ndepVersions['fumadocs-ui'] = `npm:${basePkg.name}@${basePkg.version}`;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AIMA,MAAa,YAAY,cAAc,IAAI,IAAI,OAAO,OAAO,KAAK,GAAG,CAAC,CAAC,IAAI;AAE3E,MAAa,OAAO,QAAQ,QAAQ,IAAI,EAAE;AAyB1C,MAAa,YAA4B;CACvC;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,QAAQ;EACR,kBAAkB;CACpB;CACA;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,QAAQ;EACR,kBAAkB;CACpB;CACA;EACE,OAAO;EACP,OAAO;EACP,QAAQ;EACR,kBAAkB;CACpB;CACA;EACE,OAAO;EACP,OAAO;EACP,QAAQ;EACR,kBAAkB;CACpB;CACA;EACE,OAAO;EACP,OAAO;EACP,QAAQ;EACR,kBAAkB;CACpB;CACA;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,QAAQ;EACR,kBAAkB;CACpB;CACA;EACE,OAAO;EACP,OAAO;EACP,QAAQ;EACR,kBAAkB;CACpB;CACA;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,QAAQ;EACR,kBAAkB;CACpB;AACF;AAEA,MAAM,aAAa;CAACA;CAASC;CAAQC;AAAO;AAE5C,MAAa,cAAcC;AAE3B,KAAK,MAAM,aAAa,YACtB,YAAY,UAAU,QAAoC,UAAU;AAGtE,YAAY,iBAAiB,OAAOC,KAAa,GAAGC"}

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

@@ -1,5 +0,0 @@
-export function getPageImagePath(slugs: string[]) {
-  const segments = [...slugs, 'image.webp'];
-
-  return `/og/docs/${segments.join('/')}`;
-}