@ahmedrowaihi/8n 6.0.54 → 6.0.56

package/dist/index.mjs

@@ -3738,7 +3738,7 @@ async function checkSelfUpdate() {
 		});
 		if (!res.ok) return;
 		const { version: latest } = await res.json();
-		const current = "6.0.54";
+		const current = "6.0.56";
 		if (latest !== current) console.log(pc.yellow("⚠") + pc.dim(` new version available: `) + pc.cyan(latest) + pc.dim(` (current: ${current}) — run `) + pc.cyan("npm i -g @ahmedrowaihi/8n") + pc.dim(" to update"));
 	} catch {}
 }
@@ -3851,7 +3851,7 @@ async function dev() {
 async function build({ server = false } = {}) {
 	const { config, contentDir } = await resolveProject();
 	const projectDir = process.cwd();
-	console.log(pc.cyan("8n") + pc.dim(` v6.0.54 build → ${contentDir}`));
+	console.log(pc.cyan("8n") + pc.dim(` v6.0.56 build → ${contentDir}`));
 	if (server) await runNextFlat(projectDir, "build", buildEnv({
 		config,
 		contentDir,
@@ -3924,22 +3924,14 @@ const SCAFFOLD = {
   // nav: { links: [{ text: "Blog", url: "https://example.com/blog" }] },
 };
 `,
-	["content/docs/en/meta.json"]: JSON.stringify({
-		title: "Documentation",
-		pages: ["index", "getting-started"]
-	}, null, 2) + "\n",
-	["content/docs/en/index.mdx"]: `---
+	["content/docs/index.mdx"]: `---
 title: Introduction
 description: Welcome to the docs.
 ---
 
 Welcome to your documentation. Edit files in \`content/\` and run \`8n dev\` to start.
 `,
-	["content/docs/en/getting-started/meta.json"]: JSON.stringify({
-		title: "Getting Started",
-		pages: ["installation"]
-	}, null, 2) + "\n",
-	["content/docs/en/getting-started/installation.mdx"]: `---
+	["content/docs/getting-started/installation.mdx"]: `---
 title: Installation
 description: How to install and set up the project.
 ---
@@ -3948,7 +3940,7 @@ description: How to install and set up the project.
 
 Add your installation steps here.
 `,
-	["content/home/en/index.mdx"]: `---
+	["content/home/index.mdx"]: `---
 title: Home
 ---
 
@@ -3957,21 +3949,77 @@ title: Home
     Welcome to your docs.
   </h1>
   <div className="text-muted-foreground text-lg max-w-md leading-relaxed">
-    Edit \`content/home/en/index.mdx\` to customize this page.
+    Edit \`content/home/index.mdx\` to customize this page.
   </div>
 </div>
 `,
-	["content/changelog/en/meta.json"]: JSON.stringify({ title: "Changelog" }, null, 2) + "\n",
-	["content/changelog/en/v1.0.0.mdx"]: `---
+	["content/changelog/v1.0.0.mdx"]: `---
 title: Version 1.0.0
-version: 1.0.0
-date: "${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}"
-summary: Initial release.
 ---
 
 ## Initial Release
 
 First version of the docs.
+`,
+	["CLAUDE.md"]: `# 8n Docs Project
+
+This project uses the [8n](https://github.com/ahmedrowaihi/8n) docs framework — a Next.js-based documentation site builder.
+
+## Content structure
+
+All documentation lives in \`content/\`. Each top-level subdirectory is a **section** (e.g. \`docs\`, \`api\`, \`changelog\`). Sections are auto-discovered and appear in the sidebar.
+
+\`\`\`
+content/
+  home/
+    index.mdx            ← landing page (not in sidebar)
+  docs/
+    index.mdx            ← section landing page (frontmatter only = sidebar group title)
+    getting-started/
+      installation.mdx
+  changelog/
+    v1.0.0.mdx
+\`\`\`
+
+## Adding a page
+
+Drop an \`.mdx\` file anywhere under the relevant section. Files are sorted by numeric prefix (\`01-\`, \`02-\`…); the prefix is stripped from the URL slug.
+
+## Translations (i18n)
+
+Add a sibling file with the locale suffix to translate a page:
+
+\`\`\`
+docs/
+  getting-started.mdx      ← English (default)
+  getting-started.ar.mdx   ← Arabic translation
+\`\`\`
+
+No folder restructuring needed. Files without a locale suffix belong to the default locale.
+
+## Frontmatter fields
+
+| Field         | Used in         | Notes                                  |
+|---------------|-----------------|----------------------------------------|
+| \`title\`       | all pages       | required                               |
+| \`description\` | docs/api        | shown in meta and cards                |
+| \`label\`       | any index.mdx   | overrides sidebar group display name   |
+| \`icon\`        | any index.mdx   | sidebar group icon                     |
+| \`redirect\`    | any             | immediately redirects to another URL   |
+
+## CLI commands
+
+\`\`\`bash
+8n dev               # start dev server
+8n build             # production build (static export)
+8n build --server    # production build (SSR and Server Routes)
+8n generate:api -i openapi.json -o api   # generate API docs from OpenAPI spec
+8n mcp               # start MCP server for AI-assisted authoring
+\`\`\`
+
+## MCP server
+
+Run \`8n mcp\` and point your AI assistant at it for context-aware docs authoring. The MCP server exposes the full component reference and project conventions as tools.
 `
 };
 const GITIGNORE_ENTRIES = [
@@ -4156,20 +4204,26 @@ function deploy(target) {
 
 //#endregion
 //#region src/commands/mcp.ts
-async function listMdFiles(dir) {
+function isLocaleSuffixed(filename) {
+	return /\.[a-z]{2,5}\.(mdx|md)$/.test(filename);
+}
+function stripNumericPrefix(name) {
+	return name.replace(/^\d+-/, "");
+}
+async function listKnowledgeFiles(dir) {
 	let entries;
 	try {
 		entries = await readdir(dir, { withFileTypes: true });
 	} catch {
 		return [];
 	}
-	return entries.filter((e) => !e.isDirectory() && (e.name.endsWith(".mdx") || e.name.endsWith(".md"))).map((e) => e.name);
+	return entries.filter((e) => !e.isDirectory() && (e.name.endsWith(".mdx") || e.name.endsWith(".md")) && !isLocaleSuffixed(e.name)).map((e) => e.name);
 }
 async function mcp() {
-	const mcpDir = join(getStarterDir(), "content", "mcp", "en");
+	const mcpDir = join(getStarterDir(), "content", "mcp");
 	const server = new McpServer({
 		name: "8n",
-		version: "6.0.54"
+		version: "6.0.56"
 	});
 	server.registerTool("read_me", {
 		description: "Returns how to use the 8n MCP tools. Call this BEFORE documenting anything with 8n.",
@@ -4206,7 +4260,7 @@ Example: get_component({ name: "components" }) returns all available MDX compone
 		}] };
 		return { content: [{
 			type: "text",
-			text: (await listMdFiles(mcpDir)).map((f) => basename(f, extname(f))).join("\n")
+			text: (await listKnowledgeFiles(mcpDir)).map((f) => stripNumericPrefix(basename(f, extname(f)))).filter((n) => n !== "index").join("\n")
 		}] };
 	});
 	server.registerTool("get_component", {
@@ -4217,28 +4271,23 @@ Example: get_component({ name: "components" }) returns all available MDX compone
 			type: "text",
 			text: "8n MCP knowledge not found. Reinstall @ahmedrowaihi/8n."
 		}] };
-		for (const ext of [".mdx", ".md"]) {
-			const file = join(mcpDir, `${name}${ext}`);
-			if (existsSync(file)) return { content: [{
-				type: "text",
-				text: await readFile(file, "utf-8")
-			}] };
-		}
+		const match = (await listKnowledgeFiles(mcpDir)).find((f) => stripNumericPrefix(basename(f, extname(f))) === name);
+		if (match) return { content: [{
+			type: "text",
+			text: await readFile(join(mcpDir, match), "utf-8")
+		}] };
 		return { content: [{
 			type: "text",
 			text: `Unknown topic: ${name}. Call list_components to see available topics.`
 		}] };
 	});
 	server.registerTool("analyze", {
-		description: "Runs static analysis on the user's content directory and reports issues that may break the documentation site.",
+		description: "Checks frontmatter in the user's content directory and reports missing required fields.",
 		inputSchema: {}
 	}, async () => {
 		let contentDir = join(process.cwd(), "content");
-		let locales = ["en"];
 		try {
-			const project = await resolveProject();
-			contentDir = project.contentDir;
-			locales = project.config.locales ?? ["en"];
+			contentDir = (await resolveProject()).contentDir;
 		} catch {}
 		const issues = [];
 		async function walkAll(dir) {
@@ -4256,44 +4305,11 @@ Example: get_component({ name: "components" }) returns all available MDX compone
 			}
 			return results;
 		}
-		const allFiles = await walkAll(contentDir);
-		const mdxFiles = allFiles.filter((f) => f.endsWith(".mdx") || f.endsWith(".md"));
-		const metaFiles = allFiles.filter((f) => f.endsWith("meta.json"));
+		const mdxFiles = (await walkAll(contentDir)).filter((f) => f.endsWith(".mdx") || f.endsWith(".md"));
 		for (const file of mdxFiles) {
 			const raw = await readFile(file, "utf-8").catch(() => "");
 			const rel = relative(contentDir, file);
 			if (!raw.match(/^---[\s\S]*?\ntitle:/m)) issues.push(`Missing title in frontmatter: ${rel}`);
-			if (rel.startsWith("changelog/")) {
-				if (!raw.match(/\nversion:/)) issues.push(`Changelog page missing version: ${rel}`);
-				if (!raw.match(/\ndate:/)) issues.push(`Changelog page missing date: ${rel}`);
-			}
-			const bodyMatch = raw.match(/^---[\s\S]*?---\s*([\s\S]*)$/m);
-			if (bodyMatch && bodyMatch[1].trim() === "") issues.push(`Empty page body: ${rel}`);
-		}
-		for (const file of metaFiles) {
-			const rel = relative(contentDir, file);
-			const raw = await readFile(file, "utf-8").catch(() => "");
-			let meta;
-			try {
-				meta = JSON.parse(raw);
-			} catch {
-				issues.push(`Malformed JSON: ${rel}`);
-				continue;
-			}
-			if (meta.pages) {
-				const dir = join(file, "..");
-				for (const page of meta.pages) {
-					if (page.startsWith("...") || page === "---" || page.startsWith("[")) continue;
-					if (existsSync(join(dir, page)) && !existsSync(join(dir, `${page}.mdx`)) && !existsSync(join(dir, `${page}.md`))) continue;
-					if (![".mdx", ".md"].some((ext) => existsSync(join(dir, `${page}${ext}`)))) issues.push(`meta.json references missing page "${page}": ${rel}`);
-				}
-			}
-		}
-		const defaultLocale = locales[0];
-		const otherLocales = locales.slice(1);
-		for (const locale of otherLocales) {
-			const defaultFiles = mdxFiles.filter((f) => f.includes(`/${defaultLocale}/`)).map((f) => relative(contentDir, f).replace(`${defaultLocale}/`, `${locale}/`));
-			for (const expected of defaultFiles) if (!existsSync(join(contentDir, expected))) issues.push(`Missing ${locale} translation: ${expected}`);
 		}
 		if (issues.length === 0) return { content: [{
 			type: "text",
@@ -4325,7 +4341,7 @@ async function generateApi({ input, output }) {
 
 //#endregion
 //#region src/index.ts
-const program = new Command().name("8n").description("Run your 8n docs site").version("6.0.54").addOption(new Option("--debug").hideHelp()).hook("preAction", (cmd) => {
+const program = new Command().name("8n").description("Run your 8n docs site").version("6.0.56").addOption(new Option("--debug").hideHelp()).hook("preAction", (cmd) => {
 	if (cmd.opts().debug) process.env.DEBUG_8N = "1";
 });
 program.command("init").description("Scaffold a new docs project in the current directory").action(init);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahmedrowaihi/8n",
-  "version": "6.0.54",
+  "version": "6.0.56",
   "description": "8n docs — run your docs site from your content directory",
   "bin": {
     "8n": "./dist/index.mjs"

package/starter/content/changelog/v1.0.0.ar.mdx

@@ -1,8 +1,5 @@
 ---
 title: الإصدار 1.0.0
-version: 1.0.0
-date: "2026-03-14"
-summary: الإصدار الأول — توثيق ثنائي اللغة بدعم RTL كامل، بحث محلي، خطوط ثمانية، مكوّنات MDX غنية، Excalidraw، تضمين التغريدات، رياضيات، TwoSlash، تغذيات RSS، وملف LLMs.txt.
 ---
 
 ## الإصدار الأول
@@ -50,4 +47,4 @@ summary: الإصدار الأول — توثيق ثنائي اللغة بدعم
 | تغذيات RSS            | تُولَّد تلقائيًا على `/{lang}/rss.xml` للغتين                                        |
 | ملف LLMs.txt          | `/llms.txt` و`/llms-full.txt` وفق اتفاقية [llms.txt](https://llmstxt.org)            |
 | تواريخ آخر تعديل      | تاريخ آخر تعديل git لكل صفحة عبر `fumadocs-mdx/plugins/last-modified`                |
-| سجل التغييرات         | مصدر `content/changelog/` ثنائي اللغة بحقول `version` و`date` و`summary`             |
+| سجل التغييرات         | قسم `content/changelog/` ثنائي اللغة                                                 |

package/starter/content/changelog/v1.0.0.mdx

@@ -1,8 +1,5 @@
 ---
 title: Version 1.0.0
-version: 1.0.0
-date: "2026-03-14"
-summary: Initial release — bilingual docs with full RTL support, offline search, Thmanyah fonts, rich MDX components, Excalidraw, Tweet embeds, math, TwoSlash, RSS feeds, and LLMs.txt.
 ---
 
 ## Initial Release
@@ -50,4 +47,4 @@ Full-text search powered by [Orama](https://orama.com) runs entirely in the brow
 | RSS feeds           | Auto-generated at `/{lang}/rss.xml` for both locales                                          |
 | LLMs.txt            | `/llms.txt` and `/llms-full.txt` following the [llms.txt](https://llmstxt.org) convention     |
 | Last modified dates | Per-page git last-modified date via `fumadocs-mdx/plugins/last-modified`                      |
-| Changelog           | Bilingual `content/changelog/` source with `version`, `date`, and `summary` fields            |
+| Changelog           | Bilingual `content/changelog/` section                                                        |

package/starter/content/docs/01-getting-started.ar.mdx

@@ -56,20 +56,15 @@ icon: Rocket
 
 ## إضافة صفحة جديدة
 
-ضع ملف `.mdx` في `content/docs/ar/` (وفي `content/docs/en/` للنسخة الإنجليزية):
+ضع ملف `.mdx` في `content/docs/`. للترجمة، أضف ملفاً مجاوراً بلاحقة اللغة (مثل `.ar.mdx`):
 
 <Files>
   <Folder name="content/docs" defaultOpen>
-    <Folder name="ar" defaultOpen>
-      <File name="index.mdx" />
-      <File name="getting-started.mdx" />
-      <File name="صفحتك-الجديدة.mdx" />
-    </Folder>
-    <Folder name="en">
-      <File name="index.mdx" />
-      <File name="getting-started.mdx" />
-      <File name="your-new-page.mdx" />
-    </Folder>
+    <File name="index.mdx" />
+    <File name="getting-started.mdx" />
+    <File name="getting-started.ar.mdx" />
+    <File name="صفحتك-الجديدة.mdx" />
+    <File name="your-new-page.ar.mdx" />
   </Folder>
 </Files>
 
@@ -99,7 +94,7 @@ icon: Rocket
   <Step>
     ### أنشئ مجلد المحتوى
 
-    أنشئ مجلد <code>{'content/docs/fr/'}</code> وضع فيه ملفات <code>.mdx</code> المترجمة.
+    أضف ملفاتك المترجمة كـ `.fr.mdx` مجاورة للملفات الإنجليزية (مثل `getting-started.fr.mdx`).
 
   </Step>
 </Steps>

package/starter/content/docs/01-getting-started.mdx

@@ -58,20 +58,15 @@ icon: Rocket
 
 ## Adding a new page
 
-Drop an `.mdx` file into `content/docs/en/` (and `content/docs/ar/` for the Arabic version):
+Drop an `.mdx` file into `content/docs/`. For translations, add a sibling file with the locale suffix (e.g. `.ar.mdx`):
 
 <Files>
   <Folder name="content/docs" defaultOpen>
-    <Folder name="en" defaultOpen>
-      <File name="index.mdx" />
-      <File name="getting-started.mdx" />
-      <File name="your-new-page.mdx" />
-    </Folder>
-    <Folder name="ar">
-      <File name="index.mdx" />
-      <File name="getting-started.mdx" />
-      <File name="your-new-page.mdx" />
-    </Folder>
+    <File name="index.mdx" />
+    <File name="getting-started.mdx" />
+    <File name="getting-started.ar.mdx" />
+    <File name="your-new-page.mdx" />
+    <File name="your-new-page.ar.mdx" />
   </Folder>
 </Files>
 
@@ -101,7 +96,7 @@ Drop an `.mdx` file into `content/docs/en/` (and `content/docs/ar/` for the Arab
   <Step>
     ### Create the content folder
 
-    Create `content/docs/fr/` and add your translated `.mdx` files.
+    Add your translated files as `.fr.mdx` siblings next to the English files (e.g. `getting-started.fr.mdx`).
 
   </Step>
 </Steps>

package/starter/content/mcp/02-structure.mdx

@@ -1,55 +1,84 @@
 ---
 title: Content Structure
-description: LLM reference — how to organise your content directory, locale folders, and meta.json files.
+description: LLM reference — how to organise your content directory using dot-suffix i18n.
 ---
 
 ```
 content/
-  docs/                    ← main documentation section
-    en/                    ← locale folder (must match a locale in config.locales)
-      meta.json            ← sidebar order and optional section title
-      index.mdx            ← section landing page
-      getting-started.mdx
-      guide/               ← sub-folder creates a nested sidebar group
-        meta.json
-        installation.mdx
-        configuration.mdx
-    ar/                    ← Arabic locale (optional)
-      index.mdx
-      getting-started.mdx
-  api/                     ← API reference section (optional)
-    en/
-      meta.json
-      overview.mdx
-  ui/                      ← UI component showcase (optional)
-    en/
-      meta.json
-      index.mdx
-  changelog/               ← versioned changelog (auto-sorted newest first)
-    en/
-      v2.0.0.mdx
-      v1.0.0.mdx
-  home/                    ← custom landing page (optional, replaces default)
-    en/
-      index.mdx
-```
-
-## meta.json
-
-Controls sidebar ordering and the group title for a folder.
-
-```json
-{
-  "title": "Getting Started",
-  "pages": ["installation", "configuration"]
-}
-```
-
-- `title` — optional label for the sidebar group
-- `pages` — explicit page order; omit a filename to hide that page from the sidebar
-
-If `meta.json` is absent, pages appear in filesystem order.
-
-## Fallback behaviour
-
-If a page exists in `en/` but not in `ar/`, the site automatically falls back to the English version for Arabic visitors.
+  docs/                      ← main documentation section
+    index.mdx                ← section landing page + sidebar title (default locale)
+    index.ar.mdx             ← Arabic translation of the landing page (optional)
+    01-getting-started.mdx   ← numeric prefix controls sidebar order
+    01-getting-started.ar.mdx
+    components/              ← sub-folder creates a nested sidebar group
+      index.mdx              ← group title and optional landing page
+      index.ar.mdx
+      callout.mdx
+      callout.ar.mdx
+  api/                       ← API reference (usually generated via `8n generate:api`)
+    index.mdx                ← optional: section landing page
+    listPets.mdx             ← generated endpoint page
+    showPetById.mdx
+  ui/                        ← UI component showcase (optional)
+    index.mdx
+    badge.mdx
+  changelog/                 ← changelog section
+    index.mdx
+    v2.0.0.mdx
+    v1.0.0.mdx
+  home/                      ← custom landing page (optional, replaces default)
+    index.mdx
+```
+
+## i18n: dot-suffix
+
+Translations live alongside originals as `.{locale}.mdx` siblings — no locale folders needed.
+
+```
+getting-started.mdx       ← default locale (first entry in config.locales)
+getting-started.ar.mdx    ← Arabic translation
+```
+
+If a translation is missing, the site falls back to the default locale automatically.
+
+For a single-locale site, just add plain `.mdx` files with no suffix — no configuration needed.
+
+## Numeric prefix ordering
+
+Prefix filenames with `{n}-` to control sidebar order. The prefix is stripped from the URL slug.
+
+```
+01-getting-started.mdx  → slug: getting-started, position: 1
+02-configuration.mdx    → slug: configuration, position: 2
+```
+
+## index.mdx
+
+`index.mdx` at any directory level sets the title, icon, and optional landing page for that section or folder.
+
+```mdx
+---
+label: Getting Started   # sidebar/nav label (falls back to title if omitted)
+title: Introduction      # page <title> when the page has body content
+icon: Rocket             # Lucide icon shown in the sidebar
+---
+
+Body content here makes this a real page.
+Omit the body to use it as metadata-only (the section root redirects to the first child).
+```
+
+## Adding a new section
+
+Create a directory under `content/` — it auto-appears in the sidebar and navigation.
+
+```bash
+mkdir content/guides
+# add content/guides/index.mdx with label: Guides
+# add content/guides/01-quickstart.mdx
+```
+
+Remove it by deleting the directory, or hide it without deleting:
+
+```ts title="8n.config.ts"
+sections: { guides: false }
+```

package/starter/content/mcp/03-frontmatter.mdx

@@ -9,32 +9,36 @@ Every `.mdx` file starts with a YAML frontmatter block between `---` delimiters.
 
 ```mdx
 ---
-title: My Page # required — used as the sidebar label and <title>
-description: Short blurb # optional — shown below the heading and in <meta description>
-icon: Rocket # optional — Lucide icon name shown in the sidebar
-full: true # optional — removes the sidebar and TOC for a full-width layout
-redirect: /en/docs/other # optional — immediately redirects to another URL
+title: My Page        # required — used as the page <title>
+label: Short Name     # optional — sidebar/nav label; falls back to title
+description: Blurb    # optional — shown below the heading and in <meta description>
+icon: Rocket          # optional — Lucide icon name shown in the sidebar
+full: true            # optional — removes the sidebar and TOC for a full-width layout
+redirect: /en/docs/other  # optional — immediately redirects to another URL
 ---
 ```
 
-## Changelog pages
+## index.mdx (section or folder root)
 
 ```mdx
 ---
-title: Version 2.1.0
-version: 2.1.0 # semver string — used for sorting
-date: "2025-06-01" # ISO 8601 date
-summary: What changed. # one-liner shown in the changelog list view
+label: My Section     # sidebar/nav label for the section or folder
+title: Introduction   # page <title> if the file has body content
+icon: BookOpen        # Lucide icon shown next to the section name
 ---
+
+Optional body — makes this file a real landing page.
+Omit the body to treat it as metadata-only; the section root will redirect to the first child page.
 ```
 
-## Home page (`home/[lang]/index.mdx`)
+## Home page (`home/index.mdx`)
 
 Free-form MDX — no required fields. All components and Tailwind utility classes are available.
-You can use frontmatter for `title` and `description` if you want them in `<meta>` tags.
+Use `title` and `description` frontmatter if you want them in `<meta>` tags.
 
 ## Notes
 
-- `title` is the only truly required field on docs/api/ui pages.
+- `title` is the only truly required field on any page.
+- `label` lets you have a short sidebar name while keeping a longer `title` in the page heading.
 - All string values should be unquoted unless they contain special YAML characters (`:`, `#`, etc.).
 - `icon` accepts any name from the [Lucide icon set](https://lucide.dev/icons/).

package/starter/content/mcp/04-components.mdx

@@ -84,9 +84,10 @@ Annotated file tree diagram.
 ```mdx
 <Files>
   <Folder name="content" defaultOpen>
-    <Folder name="docs/en" defaultOpen>
+    <Folder name="docs" defaultOpen>
       <File name="index.mdx" />
       <File name="getting-started.mdx" />
+      <File name="getting-started.ar.mdx" />
     </Folder>
   </Folder>
 </Files>

package/starter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahmedrowaihi/8n-starter",
-  "version": "6.0.54",
+  "version": "6.0.56",
   "type": "module",
   "sideEffects": false,
   "exports": {