@raystack/chronicle 0.1.3 → 0.3.0

package/dist/cli/index.js

@@ -9044,8 +9044,9 @@ var {
 } = import__.default;
 
 // src/cli/commands/init.ts
-import fs from "fs";
-import path from "path";
+import { execSync as execSync2 } from "child_process";
+import fs3 from "fs";
+import path4 from "path";
 
 // ../../node_modules/.bun/chalk@5.6.2/node_modules/chalk/source/vendor/ansi-styles/index.js
 var ANSI_BACKGROUND_OFFSET = 10;
@@ -9582,6 +9583,156 @@ var $stringify = publicApi.stringify;
 var $visit = visit.visit;
 var $visitAsync = visit.visitAsync;
 
+// src/cli/utils/config.ts
+import fs from "fs";
+import path from "path";
+function resolveConfigPath(contentDir) {
+  const cwdPath = path.join(process.cwd(), "chronicle.yaml");
+  if (fs.existsSync(cwdPath))
+    return cwdPath;
+  const contentPath = path.join(contentDir, "chronicle.yaml");
+  if (fs.existsSync(contentPath))
+    return contentPath;
+  return null;
+}
+function loadCLIConfig(contentDir) {
+  const configPath = resolveConfigPath(contentDir);
+  if (!configPath) {
+    console.log(source_default.red(`Error: chronicle.yaml not found in '${process.cwd()}' or '${contentDir}'`));
+    console.log(source_default.gray(`Run 'chronicle init' to create one`));
+    process.exit(1);
+  }
+  const config = $parse(fs.readFileSync(configPath, "utf-8"));
+  return {
+    config,
+    configPath,
+    contentDir
+  };
+}
+// src/cli/utils/process.ts
+function attachLifecycleHandlers(child) {
+  child.on("close", (code) => process.exit(code ?? 0));
+  process.on("SIGINT", () => child.kill("SIGINT"));
+  process.on("SIGTERM", () => child.kill("SIGTERM"));
+}
+// src/cli/utils/scaffold.ts
+import { execSync } from "child_process";
+import { createRequire as createRequire2 } from "module";
+import fs2 from "fs";
+import path3 from "path";
+
+// src/cli/utils/resolve.ts
+import path2 from "path";
+import { fileURLToPath } from "url";
+var PACKAGE_ROOT = path2.resolve(path2.dirname(fileURLToPath(import.meta.url)), "..", "..");
+
+// src/cli/utils/scaffold.ts
+var COPY_FILES = ["src", "source.config.ts", "tsconfig.json"];
+function copyRecursive(src, dest) {
+  const stat = fs2.statSync(src);
+  if (stat.isDirectory()) {
+    fs2.mkdirSync(dest, { recursive: true });
+    for (const entry of fs2.readdirSync(src)) {
+      copyRecursive(path3.join(src, entry), path3.join(dest, entry));
+    }
+  } else {
+    fs2.copyFileSync(src, dest);
+  }
+}
+function ensureRemoved(targetPath) {
+  try {
+    fs2.lstatSync(targetPath);
+    fs2.rmSync(targetPath, { recursive: true, force: true });
+  } catch {}
+}
+function detectPackageManager() {
+  if (process.env.npm_config_user_agent) {
+    return process.env.npm_config_user_agent.split("/")[0];
+  }
+  const cwd = process.cwd();
+  if (fs2.existsSync(path3.join(cwd, "bun.lock")) || fs2.existsSync(path3.join(cwd, "bun.lockb")))
+    return "bun";
+  if (fs2.existsSync(path3.join(cwd, "pnpm-lock.yaml")))
+    return "pnpm";
+  if (fs2.existsSync(path3.join(cwd, "yarn.lock")))
+    return "yarn";
+  return "npm";
+}
+function generateNextConfig(scaffoldPath) {
+  const config = `import { createMDX } from 'fumadocs-mdx/next'
+
+const withMDX = createMDX()
+
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  reactStrictMode: true,
+}
+
+export default withMDX(nextConfig)
+`;
+  fs2.writeFileSync(path3.join(scaffoldPath, "next.config.mjs"), config);
+}
+function createPackageJson() {
+  return {
+    name: "chronicle-docs",
+    private: true,
+    dependencies: {
+      "@raystack/chronicle": `^${getChronicleVersion()}`
+    },
+    devDependencies: {
+      "@raystack/tools-config": "0.56.0",
+      "openapi-types": "^12.1.3",
+      typescript: "5.9.3",
+      "@types/react": "^19.2.10",
+      "@types/node": "^25.1.0"
+    }
+  };
+}
+function ensureDeps() {
+  const cwd = process.cwd();
+  const cwdPkgJson = path3.join(cwd, "package.json");
+  const cwdNodeModules = path3.join(cwd, "node_modules");
+  if (fs2.existsSync(cwdPkgJson) && fs2.existsSync(cwdNodeModules)) {
+    return;
+  }
+  if (!fs2.existsSync(cwdPkgJson)) {
+    fs2.writeFileSync(cwdPkgJson, JSON.stringify(createPackageJson(), null, 2) + `
+`);
+  }
+  if (!fs2.existsSync(cwdNodeModules)) {
+    const pm = detectPackageManager();
+    console.log(source_default.cyan(`Installing dependencies with ${pm}...`));
+    execSync(`${pm} install`, { cwd, stdio: "inherit" });
+  }
+}
+function getChronicleVersion() {
+  const pkgPath = path3.join(PACKAGE_ROOT, "package.json");
+  const pkg = JSON.parse(fs2.readFileSync(pkgPath, "utf-8"));
+  return pkg.version;
+}
+function resolveNextCli() {
+  const chronicleRequire = createRequire2(path3.join(PACKAGE_ROOT, "package.json"));
+  return chronicleRequire.resolve("next/dist/bin/next");
+}
+function scaffoldDir(contentDir) {
+  const scaffoldPath = path3.join(process.cwd(), ".chronicle");
+  if (!fs2.existsSync(scaffoldPath)) {
+    fs2.mkdirSync(scaffoldPath, { recursive: true });
+  }
+  for (const name of COPY_FILES) {
+    const src = path3.join(PACKAGE_ROOT, name);
+    const dest = path3.join(scaffoldPath, name);
+    ensureRemoved(dest);
+    copyRecursive(src, dest);
+  }
+  generateNextConfig(scaffoldPath);
+  const contentLink = path3.join(scaffoldPath, "content");
+  ensureRemoved(contentLink);
+  fs2.symlinkSync(path3.resolve(contentDir), contentLink);
+  ensureDeps();
+  console.log(source_default.gray(`Scaffold: ${scaffoldPath}`));
+  return scaffoldPath;
+}
 // src/cli/commands/init.ts
 function createConfig() {
   return {
@@ -9591,6 +9742,28 @@ function createConfig() {
     search: { enabled: true, placeholder: "Search documentation..." }
   };
 }
+function createPackageJson2(name) {
+  return {
+    name,
+    private: true,
+    type: "module",
+    scripts: {
+      dev: "chronicle dev",
+      build: "chronicle build",
+      start: "chronicle start"
+    },
+    dependencies: {
+      "@raystack/chronicle": `^${getChronicleVersion()}`
+    },
+    devDependencies: {
+      "@raystack/tools-config": "0.56.0",
+      "openapi-types": "^12.1.3",
+      typescript: "5.9.3",
+      "@types/react": "^19.2.10",
+      "@types/node": "^25.1.0"
+    }
+  };
+}
 var sampleMdx = `---
 title: Welcome
 description: Getting started with your documentation
@@ -9601,79 +9774,128 @@ order: 1
 
 This is your documentation home page.
 `;
-var initCommand = new Command("init").description("Initialize a new Chronicle project").option("-d, --dir <path>", "Content directory", ".").action((options) => {
-  const contentDir = path.resolve(options.dir);
-  if (!fs.existsSync(contentDir)) {
-    fs.mkdirSync(contentDir, { recursive: true });
+var initCommand = new Command("init").description("Initialize a new Chronicle project").option("-c, --content <path>", "Content directory name", "content").action((options) => {
+  const projectDir = process.cwd();
+  const dirName = path4.basename(projectDir) || "docs";
+  const contentDir = path4.join(projectDir, options.content);
+  if (!fs3.existsSync(contentDir)) {
+    fs3.mkdirSync(contentDir, { recursive: true });
     console.log(source_default.green("✓"), "Created", contentDir);
   }
-  const configPath = path.join(contentDir, "chronicle.yaml");
-  if (!fs.existsSync(configPath)) {
-    fs.writeFileSync(configPath, $stringify(createConfig()));
+  const packageJsonPath = path4.join(projectDir, "package.json");
+  if (!fs3.existsSync(packageJsonPath)) {
+    fs3.writeFileSync(packageJsonPath, JSON.stringify(createPackageJson2(dirName), null, 2) + `
+`);
+    console.log(source_default.green("✓"), "Created", packageJsonPath);
+  } else {
+    const existing = JSON.parse(fs3.readFileSync(packageJsonPath, "utf-8"));
+    const template = createPackageJson2(dirName);
+    let updated = false;
+    if (existing.type !== "module") {
+      existing.type = "module";
+      updated = true;
+    }
+    if (!existing.scripts)
+      existing.scripts = {};
+    for (const [key, value] of Object.entries(template.scripts)) {
+      if (!existing.scripts[key]) {
+        existing.scripts[key] = value;
+        updated = true;
+      }
+    }
+    if (!existing.dependencies)
+      existing.dependencies = {};
+    for (const [key, value] of Object.entries(template.dependencies)) {
+      if (!existing.dependencies[key]) {
+        existing.dependencies[key] = value;
+        updated = true;
+      }
+    }
+    if (!existing.devDependencies)
+      existing.devDependencies = {};
+    for (const [key, value] of Object.entries(template.devDependencies)) {
+      if (!existing.devDependencies[key]) {
+        existing.devDependencies[key] = value;
+        updated = true;
+      }
+    }
+    if (updated) {
+      fs3.writeFileSync(packageJsonPath, JSON.stringify(existing, null, 2) + `
+`);
+      console.log(source_default.green("✓"), "Updated", packageJsonPath, "with missing scripts/deps");
+    } else {
+      console.log(source_default.yellow("⚠"), packageJsonPath, "already has all required entries");
+    }
+  }
+  const configPath = path4.join(projectDir, "chronicle.yaml");
+  if (!fs3.existsSync(configPath)) {
+    fs3.writeFileSync(configPath, $stringify(createConfig()));
     console.log(source_default.green("✓"), "Created", configPath);
   } else {
     console.log(source_default.yellow("⚠"), configPath, "already exists");
   }
-  const indexPath = path.join(contentDir, "index.mdx");
-  if (!fs.existsSync(indexPath)) {
-    fs.writeFileSync(indexPath, sampleMdx);
+  const contentFiles = fs3.readdirSync(contentDir);
+  if (contentFiles.length === 0) {
+    const indexPath = path4.join(contentDir, "index.mdx");
+    fs3.writeFileSync(indexPath, sampleMdx);
     console.log(source_default.green("✓"), "Created", indexPath);
   }
+  const gitignorePath = path4.join(projectDir, ".gitignore");
+  const gitignoreEntries = [".chronicle", "node_modules", ".next"];
+  if (fs3.existsSync(gitignorePath)) {
+    const existing = fs3.readFileSync(gitignorePath, "utf-8");
+    const missing = gitignoreEntries.filter((e) => !existing.includes(e));
+    if (missing.length > 0) {
+      fs3.appendFileSync(gitignorePath, `
+${missing.join(`
+`)}
+`);
+      console.log(source_default.green("✓"), "Added", missing.join(", "), "to .gitignore");
+    }
+  } else {
+    fs3.writeFileSync(gitignorePath, `${gitignoreEntries.join(`
+`)}
+`);
+    console.log(source_default.green("✓"), "Created .gitignore");
+  }
+  const pm = detectPackageManager();
+  console.log(source_default.cyan(`
+Installing dependencies with ${pm}...`));
+  execSync2(`${pm} install`, { cwd: projectDir, stdio: "inherit" });
+  loadCLIConfig(contentDir);
+  scaffoldDir(contentDir);
+  const runCmd = pm === "npm" ? "npx" : pm === "bun" ? "bunx" : `${pm} dlx`;
   console.log(source_default.green(`
 ✓ Chronicle initialized!`));
   console.log(`
-Run`, source_default.cyan("chronicle dev"), "to start development server");
+Run`, source_default.cyan(`${runCmd} chronicle dev`), "to start development server");
 });
 
 // src/cli/commands/dev.ts
 import { spawn } from "child_process";
-import path3 from "path";
-import { fileURLToPath } from "url";
-
-// src/cli/utils/config.ts
-import fs2 from "fs";
-import path2 from "path";
-function resolveContentDir(contentFlag) {
-  if (contentFlag)
-    return path2.resolve(contentFlag);
-  if (process.env.CHRONICLE_CONTENT_DIR)
-    return path2.resolve(process.env.CHRONICLE_CONTENT_DIR);
-  return process.cwd();
-}
-function loadCLIConfig(contentDir) {
-  const configPath = path2.join(contentDir, "chronicle.yaml");
-  if (!fs2.existsSync(configPath)) {
-    console.log(source_default.red("Error: chronicle.yaml not found in"), contentDir);
-    console.log(source_default.gray(`Run 'chronicle init' to create one`));
+import path5 from "path";
+import fs4 from "fs";
+var devCommand = new Command("dev").description("Start development server").option("-p, --port <port>", "Port number", "3000").action((options) => {
+  const scaffoldPath = path5.join(process.cwd(), ".chronicle");
+  if (!fs4.existsSync(scaffoldPath)) {
+    console.log(source_default.red("Error: .chronicle/ not found. Run"), source_default.cyan("chronicle init"), source_default.red("first."));
+    process.exit(1);
+  }
+  let nextCli;
+  try {
+    nextCli = resolveNextCli();
+  } catch {
+    console.log(source_default.red("Error: Next.js CLI not found. Run"), source_default.cyan("chronicle init"), source_default.red("first."));
     process.exit(1);
   }
-  const config = $parse(fs2.readFileSync(configPath, "utf-8"));
-  return {
-    config,
-    configPath,
-    contentDir
-  };
-}
-// src/cli/utils/process.ts
-function attachLifecycleHandlers(child) {
-  child.on("close", (code) => process.exit(code ?? 0));
-  process.on("SIGINT", () => child.kill("SIGINT"));
-  process.on("SIGTERM", () => child.kill("SIGTERM"));
-}
-// src/cli/commands/dev.ts
-var PACKAGE_ROOT = path3.resolve(path3.dirname(fileURLToPath(import.meta.url)), "..", "..");
-var nextBin = path3.join(PACKAGE_ROOT, "node_modules", ".bin", process.platform === "win32" ? "next.cmd" : "next");
-var devCommand = new Command("dev").description("Start development server").option("-p, --port <port>", "Port number", "3000").option("-c, --content <path>", "Content directory").action((options) => {
-  const contentDir = resolveContentDir(options.content);
-  loadCLIConfig(contentDir);
   console.log(source_default.cyan("Starting dev server..."));
-  console.log(source_default.gray(`Content: ${contentDir}`));
-  const child = spawn(nextBin, ["dev", "-p", options.port], {
+  const child = spawn(process.execPath, [nextCli, "dev", "-p", options.port], {
     stdio: "inherit",
-    cwd: PACKAGE_ROOT,
+    cwd: scaffoldPath,
     env: {
       ...process.env,
-      CHRONICLE_CONTENT_DIR: contentDir
+      CHRONICLE_PROJECT_ROOT: process.cwd(),
+      CHRONICLE_CONTENT_DIR: "./content"
     }
   });
   attachLifecycleHandlers(child);
@@ -9681,21 +9903,29 @@ var devCommand = new Command("dev").description("Start development server").opti
 
 // src/cli/commands/build.ts
 import { spawn as spawn2 } from "child_process";
-import path4 from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
-var PACKAGE_ROOT2 = path4.resolve(path4.dirname(fileURLToPath2(import.meta.url)), "..", "..");
-var nextBin2 = path4.join(PACKAGE_ROOT2, "node_modules", ".bin", process.platform === "win32" ? "next.cmd" : "next");
-var buildCommand = new Command("build").description("Build for production").option("-c, --content <path>", "Content directory").action((options) => {
-  const contentDir = resolveContentDir(options.content);
-  loadCLIConfig(contentDir);
+import path6 from "path";
+import fs5 from "fs";
+var buildCommand = new Command("build").description("Build for production").action(() => {
+  const scaffoldPath = path6.join(process.cwd(), ".chronicle");
+  if (!fs5.existsSync(scaffoldPath)) {
+    console.log(source_default.red("Error: .chronicle/ not found. Run"), source_default.cyan("chronicle init"), source_default.red("first."));
+    process.exit(1);
+  }
+  let nextCli;
+  try {
+    nextCli = resolveNextCli();
+  } catch {
+    console.log(source_default.red("Error: Next.js CLI not found. Run"), source_default.cyan("chronicle init"), source_default.red("first."));
+    process.exit(1);
+  }
   console.log(source_default.cyan("Building for production..."));
-  console.log(source_default.gray(`Content: ${contentDir}`));
-  const child = spawn2(nextBin2, ["build"], {
+  const child = spawn2(process.execPath, [nextCli, "build"], {
     stdio: "inherit",
-    cwd: PACKAGE_ROOT2,
+    cwd: scaffoldPath,
     env: {
       ...process.env,
-      CHRONICLE_CONTENT_DIR: contentDir
+      CHRONICLE_PROJECT_ROOT: process.cwd(),
+      CHRONICLE_CONTENT_DIR: "./content"
     }
   });
   attachLifecycleHandlers(child);
@@ -9703,21 +9933,29 @@ var buildCommand = new Command("build").description("Build for production").opti
 
 // src/cli/commands/start.ts
 import { spawn as spawn3 } from "child_process";
-import path5 from "path";
-import { fileURLToPath as fileURLToPath3 } from "url";
-var PACKAGE_ROOT3 = path5.resolve(path5.dirname(fileURLToPath3(import.meta.url)), "..", "..");
-var nextBin3 = path5.join(PACKAGE_ROOT3, "node_modules", ".bin", process.platform === "win32" ? "next.cmd" : "next");
-var startCommand = new Command("start").description("Start production server").option("-p, --port <port>", "Port number", "3000").option("-c, --content <path>", "Content directory").action((options) => {
-  const contentDir = resolveContentDir(options.content);
-  loadCLIConfig(contentDir);
+import path7 from "path";
+import fs6 from "fs";
+var startCommand = new Command("start").description("Start production server").option("-p, --port <port>", "Port number", "3000").action((options) => {
+  const scaffoldPath = path7.join(process.cwd(), ".chronicle");
+  if (!fs6.existsSync(scaffoldPath)) {
+    console.log(source_default.red("Error: .chronicle/ not found. Run"), source_default.cyan("chronicle init"), source_default.red("first."));
+    process.exit(1);
+  }
+  let nextCli;
+  try {
+    nextCli = resolveNextCli();
+  } catch {
+    console.log(source_default.red("Error: Next.js CLI not found. Run"), source_default.cyan("chronicle init"), source_default.red("first."));
+    process.exit(1);
+  }
   console.log(source_default.cyan("Starting production server..."));
-  console.log(source_default.gray(`Content: ${contentDir}`));
-  const child = spawn3(nextBin3, ["start", "-p", options.port], {
+  const child = spawn3(process.execPath, [nextCli, "start", "-p", options.port], {
     stdio: "inherit",
-    cwd: PACKAGE_ROOT3,
+    cwd: scaffoldPath,
     env: {
       ...process.env,
-      CHRONICLE_CONTENT_DIR: contentDir
+      CHRONICLE_PROJECT_ROOT: process.cwd(),
+      CHRONICLE_CONTENT_DIR: "./content"
     }
   });
   attachLifecycleHandlers(child);
@@ -9725,22 +9963,30 @@ var startCommand = new Command("start").description("Start production server").o
 
 // src/cli/commands/serve.ts
 import { spawn as spawn4 } from "child_process";
-import path6 from "path";
-import { fileURLToPath as fileURLToPath4 } from "url";
-var PACKAGE_ROOT4 = path6.resolve(path6.dirname(fileURLToPath4(import.meta.url)), "..", "..");
-var nextBin4 = path6.join(PACKAGE_ROOT4, "node_modules", ".bin", process.platform === "win32" ? "next.cmd" : "next");
-var serveCommand = new Command("serve").description("Build and start production server").option("-p, --port <port>", "Port number", "3000").option("-c, --content <path>", "Content directory").action((options) => {
-  const contentDir = resolveContentDir(options.content);
-  loadCLIConfig(contentDir);
+import path8 from "path";
+import fs7 from "fs";
+var serveCommand = new Command("serve").description("Build and start production server").option("-p, --port <port>", "Port number", "3000").action((options) => {
+  const scaffoldPath = path8.join(process.cwd(), ".chronicle");
+  if (!fs7.existsSync(scaffoldPath)) {
+    console.log(source_default.red("Error: .chronicle/ not found. Run"), source_default.cyan("chronicle init"), source_default.red("first."));
+    process.exit(1);
+  }
+  let nextCli;
+  try {
+    nextCli = resolveNextCli();
+  } catch {
+    console.log(source_default.red("Error: Next.js CLI not found. Run"), source_default.cyan("chronicle init"), source_default.red("first."));
+    process.exit(1);
+  }
   const env2 = {
     ...process.env,
-    CHRONICLE_CONTENT_DIR: contentDir
+    CHRONICLE_PROJECT_ROOT: process.cwd(),
+    CHRONICLE_CONTENT_DIR: "./content"
   };
   console.log(source_default.cyan("Building for production..."));
-  console.log(source_default.gray(`Content: ${contentDir}`));
-  const buildChild = spawn4(nextBin4, ["build"], {
+  const buildChild = spawn4(process.execPath, [nextCli, "build"], {
     stdio: "inherit",
-    cwd: PACKAGE_ROOT4,
+    cwd: scaffoldPath,
     env: env2
   });
   process.once("SIGINT", () => buildChild.kill("SIGINT"));
@@ -9751,9 +9997,9 @@ var serveCommand = new Command("serve").description("Build and start production
       process.exit(code ?? 1);
     }
     console.log(source_default.cyan("Starting production server..."));
-    const startChild = spawn4(nextBin4, ["start", "-p", options.port], {
+    const startChild = spawn4(process.execPath, [nextCli, "start", "-p", options.port], {
       stdio: "inherit",
-      cwd: PACKAGE_ROOT4,
+      cwd: scaffoldPath,
       env: env2
     });
     attachLifecycleHandlers(startChild);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raystack/chronicle",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "description": "Config-driven documentation framework",
   "license": "Apache-2.0",
   "type": "module",
@@ -10,7 +10,8 @@
     "src",
     "templates",
     "next.config.mjs",
-    "source.config.ts"
+    "source.config.ts",
+    "tsconfig.json"
   ],
   "bin": {
     "chronicle": "./bin/chronicle.js"
@@ -27,7 +28,6 @@
     "@types/react": "^19.2.10",
     "@types/react-dom": "^19.2.3",
     "@types/semver": "^7.7.1",
-    "openapi-types": "^12.1.3",
     "semver": "^7.7.4",
     "typescript": "5.9.3"
   },
@@ -56,6 +56,7 @@
     "slugify": "^1.6.6",
     "unified": "^11.0.5",
     "unist-util-visit": "^5.1.0",
+    "openapi-types": "^12.1.3",
     "yaml": "^2.8.2",
     "zod": "^4.3.6"
   }

package/source.config.ts

@@ -11,6 +11,7 @@ export const docs = defineDocs({
   docs: {
     schema: frontmatterSchema.extend({
       order: z.number().optional(),
+      lastModified: z.string().optional(),
     }),
     postprocess: {
       includeProcessedMarkdown: true,

package/src/app/[[...slug]]/page.tsx

@@ -1,3 +1,4 @@
+import type { Metadata, ResolvingMetadata } from 'next'
 import { notFound } from 'next/navigation'
 import type { MDXContent } from 'mdx/types'
 import { loadConfig } from '@/lib/config'
@@ -16,6 +17,41 @@ interface PageData {
   toc: { title: string; url: string; depth: number }[]
 }
 
+export async function generateMetadata(
+  { params }: PageProps,
+  parent: ResolvingMetadata,
+): Promise<Metadata> {
+  const { slug } = await params
+  const page = source.getPage(slug)
+  if (!page) return {}
+  const config = loadConfig()
+  const data = page.data as PageData
+  const parentMetadata = await parent
+
+  const metadata: Metadata = {
+    title: data.title,
+    description: data.description,
+  }
+
+  if (config.url) {
+    const ogParams = new URLSearchParams({ title: data.title })
+    if (data.description) ogParams.set('description', data.description)
+    metadata.openGraph = {
+      ...parentMetadata.openGraph,
+      title: data.title,
+      description: data.description,
+      images: [{ url: `/og?${ogParams.toString()}`, width: 1200, height: 630 }],
+    }
+    metadata.twitter = {
+      ...parentMetadata.twitter,
+      title: data.title,
+      description: data.description,
+    }
+  }
+
+  return metadata
+}
+
 export default async function DocsPage({ params }: PageProps) {
   const { slug } = await params
   const config = loadConfig()
@@ -33,20 +69,33 @@ export default async function DocsPage({ params }: PageProps) {
 
   const tree = buildPageTree()
 
+  const pageUrl = config.url ? `${config.url}/${(slug ?? []).join('/')}` : undefined
+
   return (
-    <Page
-      page={{
-        slug: slug ?? [],
-        frontmatter: {
-          title: data.title,
+    <>
+      <script type="application/ld+json">
+        {JSON.stringify({
+          '@context': 'https://schema.org',
+          '@type': 'Article',
+          headline: data.title,
           description: data.description,
-        },
-        content: <MDXBody components={mdxComponents} />,
-        toc: data.toc ?? [],
-      }}
-      config={config}
-      tree={tree}
-    />
+          ...(pageUrl && { url: pageUrl }),
+        }, null, 2)}
+      </script>
+      <Page
+        page={{
+          slug: slug ?? [],
+          frontmatter: {
+            title: data.title,
+            description: data.description,
+          },
+          content: <MDXBody components={mdxComponents} />,
+          toc: data.toc ?? [],
+        }}
+        config={config}
+        tree={tree}
+      />
+    </>
   )
 }