@ahmedrowaihi/8n 6.0.55 → 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.55";
+		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.55 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.55"
+		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.55").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.55",
+  "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/mcp/02-structure.mdx

@@ -22,7 +22,7 @@ content/
   ui/                        ← UI component showcase (optional)
     index.mdx
     badge.mdx
-  changelog/                 ← versioned changelog, sorted newest-first
+  changelog/                 ← changelog section
     index.mdx
     v2.0.0.mdx
     v1.0.0.mdx

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

@@ -31,17 +31,6 @@ 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.
 ```
 
-## Changelog pages
-
-```mdx
----
-title: Version 2.1.0
-version: 2.1.0        # semver string — used for sorting
-date: "2025-06-01"    # ISO 8601 date (quoted to prevent YAML date parsing)
-summary: What changed.  # one-liner shown in the changelog list view
----
-```
-
 ## Home page (`home/index.mdx`)
 
 Free-form MDX — no required fields. All components and Tailwind utility classes are available.
@@ -49,7 +38,7 @@ 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/package.json

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