doccupine 0.0.87 → 0.0.88

package/dist/index.js

@@ -13,6 +13,8 @@ import { findAvailablePort, generateSlug, getFullSlug, escapeTemplateContent, }
 import { generateMetadataBlock, generateRuntimeOnlyMetadataBlock, } from "./lib/metadata.js";
 import { nextConfigTemplate } from "./templates/next.config.js";
 import { proxyTemplate } from "./templates/proxy.js";
+import { robotsTemplate } from "./templates/app/robots.js";
+import { sitemapTemplate } from "./templates/app/sitemap.js";
 export { generateSlug, getFullSlug, escapeTemplateContent, } from "./lib/utils.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -72,6 +74,7 @@ class MDXToNextJSGenerator {
         console.log(chalk.white("   npm install && npm run dev"));
     }
     async createNextJSStructure() {
+        const siteUrl = await this.loadSiteUrl();
         const structure = {
             ...appStructure,
             "next.config.ts": nextConfigTemplate(this.analyticsConfig),
@@ -82,6 +85,7 @@ class MDXToNextJSGenerator {
             "navigation.json": `[]\n`,
             "sections.json": `[]\n`,
             "theme.json": `{}\n`,
+            "app/robots.ts": robotsTemplate(siteUrl !== null),
             "app/layout.tsx": this.generateRootLayout(),
         };
         for (const [filePath, content] of Object.entries(structure)) {
@@ -89,6 +93,7 @@ class MDXToNextJSGenerator {
             await fs.ensureDir(path.dirname(fullPath));
             await fs.writeFile(fullPath, String(await content), "utf8");
         }
+        await this.updateSitemap();
     }
     async createStartingDocs() {
         const structure = startingDocsStructure;
@@ -326,6 +331,10 @@ class MDXToNextJSGenerator {
                 if (fileName === "sections.json") {
                     await this.reloadSections();
                 }
+                if (fileName === "config.json") {
+                    await this.updateSitemap();
+                    await this.updateRobots();
+                }
             }
             catch (error) {
                 console.error(chalk.red(`❌ Error copying ${fileName}:`), error);
@@ -344,6 +353,10 @@ class MDXToNextJSGenerator {
                 if (fileName === "sections.json") {
                     await this.reloadSections();
                 }
+                if (fileName === "config.json") {
+                    await this.updateSitemap();
+                    await this.updateRobots();
+                }
             }
             catch (error) {
                 console.error(chalk.red(`❌ Error removing ${fileName}:`), error);
@@ -607,6 +620,22 @@ class MDXToNextJSGenerator {
         const { data: frontmatter } = matter(content);
         const { sectionSlug, pageSlug } = this.determineSectionForFile(file, frontmatter);
         const fullSlug = getFullSlug(pageSlug, sectionSlug);
+        let lastModified;
+        if (frontmatter.date) {
+            const parsed = new Date(frontmatter.date);
+            if (!Number.isNaN(parsed.getTime())) {
+                lastModified = parsed.toISOString();
+            }
+        }
+        if (!lastModified) {
+            try {
+                const stats = await fs.stat(fullPath);
+                lastModified = stats.mtime.toISOString();
+            }
+            catch {
+                // ignore
+            }
+        }
         return {
             slug: fullSlug,
             title: frontmatter.title || "Untitled",
@@ -617,6 +646,7 @@ class MDXToNextJSGenerator {
             categoryOrder: frontmatter.categoryOrder || 0,
             order: frontmatter.order || 0,
             section: sectionSlug,
+            lastModified,
         };
     }
     async buildAllPagesMeta() {
@@ -650,6 +680,7 @@ class MDXToNextJSGenerator {
             }
             await this.updatePagesIndex();
             await this.updateRootLayout();
+            await this.updateSitemap();
             await this.generateSectionIndexPages();
             console.log(chalk.green(`✅ Generated page for: ${filePath}`));
             await this.maybeUpdateSections();
@@ -673,6 +704,7 @@ class MDXToNextJSGenerator {
             }
             await this.updatePagesIndex();
             await this.updateRootLayout();
+            await this.updateSitemap();
             console.log(chalk.green(`✅ Removed page for: ${filePath}`));
             await this.maybeUpdateSections();
         }
@@ -845,6 +877,72 @@ export default function Page() {
         const layoutContent = await this.generateRootLayout();
         await fs.writeFile(path.join(this.outputDir, "app", "layout.tsx"), layoutContent, "utf8");
     }
+    async loadSiteUrl() {
+        const configPath = path.join(this.rootDir, "config.json");
+        try {
+            if (await fs.pathExists(configPath)) {
+                const content = await fs.readFile(configPath, "utf8");
+                const parsed = JSON.parse(content);
+                if (typeof parsed.url === "string" && parsed.url.trim() !== "") {
+                    return parsed.url.trim().replace(/\/$/, "");
+                }
+            }
+        }
+        catch (error) {
+            console.warn(chalk.yellow("⚠️ Error reading config.json"), error);
+        }
+        return null;
+    }
+    buildSitemapEntries(pages) {
+        const sectionSlugs = new Set((this.sectionsConfig || [])
+            .map((s) => s.slug)
+            .filter((s) => typeof s === "string" && s !== ""));
+        const entries = pages.map((page) => {
+            let priority = 0.5;
+            if (page.slug === "") {
+                priority = 1.0;
+            }
+            else if (sectionSlugs.has(page.slug)) {
+                priority = 0.8;
+            }
+            return {
+                slug: page.slug,
+                lastModified: page.lastModified,
+                changeFrequency: "weekly",
+                priority,
+            };
+        });
+        if (!entries.some((entry) => entry.slug === "")) {
+            entries.unshift({
+                slug: "",
+                changeFrequency: "weekly",
+                priority: 1.0,
+            });
+        }
+        return entries;
+    }
+    async updateSitemap() {
+        const sitemapPath = path.join(this.outputDir, "app", "sitemap.ts");
+        const siteUrl = await this.loadSiteUrl();
+        if (!siteUrl) {
+            if (await fs.pathExists(sitemapPath)) {
+                await fs.remove(sitemapPath);
+                console.log(chalk.yellow("🗑️ Removed sitemap.ts (no site URL configured)"));
+            }
+            return;
+        }
+        const pages = await this.buildAllPagesMeta();
+        const entries = this.buildSitemapEntries(pages);
+        await fs.writeFile(sitemapPath, sitemapTemplate(entries), "utf8");
+        console.log(chalk.green(`🗺️ Generated sitemap.ts with ${entries.length} page(s) using ${siteUrl}`));
+    }
+    async updateRobots() {
+        const siteUrl = await this.loadSiteUrl();
+        await fs.writeFile(path.join(this.outputDir, "app", "robots.ts"), robotsTemplate(siteUrl !== null), "utf8");
+        console.log(chalk.green(siteUrl
+            ? `🤖 Regenerated robots.ts with sitemap link`
+            : `🤖 Regenerated robots.ts (no sitemap link)`));
+    }
     async stop() {
         if (this.watcher) {
             await this.watcher.close();

package/dist/lib/structures.js

@@ -10,7 +10,6 @@ import { ragRoutesTemplate } from "../templates/app/api/rag/route.js";
 import { searchRoutesTemplate } from "../templates/app/api/search/route.js";
 import { routesTemplate } from "../templates/app/api/theme/routes.js";
 import { notFoundTemplate } from "../templates/app/not-found.js";
-import { robotsTemplate } from "../templates/app/robots.js";
 import { themeTemplate } from "../templates/app/theme.js";
 import { chatTemplate } from "../templates/components/Chat.js";
 import { clickOutsideTemplate } from "../templates/components/ClickOutside.js";
@@ -121,7 +120,6 @@ export const appStructure = {
     "package.json": packageJsonTemplate,
     "tsconfig.json": tsconfigTemplate,
     "app/not-found.tsx": notFoundTemplate,
-    "app/robots.ts": robotsTemplate,
     "app/theme.ts": themeTemplate,
     "app/api/mcp/route.ts": mcpRoutesTemplate,
     "app/api/rag/route.ts": ragRoutesTemplate,

package/dist/lib/types.d.ts

@@ -14,6 +14,7 @@ export interface PageMeta {
     categoryOrder: number;
     order: number;
     section: string;
+    lastModified?: string;
 }
 export interface SectionConfig {
     label: string;

package/dist/templates/app/robots.d.ts

@@ -1 +1 @@
-export declare const robotsTemplate = "import type { MetadataRoute } from \"next\";\n\nexport default function robots(): MetadataRoute.Robots {\n  return {\n    rules: {\n      userAgent: \"*\",\n      allow: \"/\",\n    },\n  };\n}\n";
+export declare const robotsTemplate: (hasSiteUrl: boolean) => string;

package/dist/templates/app/robots.js

@@ -1,4 +1,6 @@
-export const robotsTemplate = `import type { MetadataRoute } from "next";
+export const robotsTemplate = (hasSiteUrl) => {
+    if (!hasSiteUrl) {
+        return `import type { MetadataRoute } from "next";
 
 export default function robots(): MetadataRoute.Robots {
   return {
@@ -9,3 +11,28 @@ export default function robots(): MetadataRoute.Robots {
   };
 }
 `;
+    }
+    return `import type { MetadataRoute } from "next";
+import { config } from "@/utils/config";
+
+function resolveBaseUrl(): string | null {
+  const raw = process.env.NEXT_PUBLIC_SITE_URL ?? config.url;
+  if (!raw) return null;
+  return raw.replace(/\\/$/, "");
+}
+
+export default function robots(): MetadataRoute.Robots {
+  const base = resolveBaseUrl();
+  const rules: MetadataRoute.Robots = {
+    rules: {
+      userAgent: "*",
+      allow: "/",
+    },
+  };
+  if (base) {
+    rules.sitemap = \`\${base}/sitemap.xml\`;
+  }
+  return rules;
+}
+`;
+};

package/dist/templates/app/sitemap.d.ts

@@ -0,0 +1,7 @@
+export interface SitemapEntry {
+    slug: string;
+    lastModified?: string;
+    changeFrequency: "weekly";
+    priority: number;
+}
+export declare const sitemapTemplate: (entries: SitemapEntry[]) => string;

package/dist/templates/app/sitemap.js

@@ -0,0 +1,56 @@
+function formatEntries(entries) {
+    const lines = entries.map((entry) => {
+        const parts = [
+            `    slug: ${JSON.stringify(entry.slug)}`,
+            entry.lastModified
+                ? `    lastModified: ${JSON.stringify(entry.lastModified)}`
+                : null,
+            `    changeFrequency: ${JSON.stringify(entry.changeFrequency)}`,
+            `    priority: ${entry.priority}`,
+        ].filter(Boolean);
+        return `  {\n${parts.join(",\n")},\n  }`;
+    });
+    return `[\n${lines.join(",\n")},\n]`;
+}
+export const sitemapTemplate = (entries) => {
+    const entriesLiteral = formatEntries(entries);
+    return `import type { MetadataRoute } from "next";
+import { config } from "@/utils/config";
+
+type ChangeFrequency =
+  | "always"
+  | "hourly"
+  | "daily"
+  | "weekly"
+  | "monthly"
+  | "yearly"
+  | "never";
+
+interface Entry {
+  slug: string;
+  lastModified?: string;
+  changeFrequency: ChangeFrequency;
+  priority: number;
+}
+
+const ENTRIES: Entry[] = ${entriesLiteral};
+
+function resolveBaseUrl(): string | null {
+  const raw = process.env.NEXT_PUBLIC_SITE_URL ?? config.url;
+  if (!raw) return null;
+  return raw.replace(/\\/$/, "");
+}
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  const base = resolveBaseUrl();
+  if (!base) return [];
+
+  return ENTRIES.map((entry) => ({
+    url: entry.slug === "" ? base : \`\${base}/\${entry.slug}\`,
+    lastModified: entry.lastModified ? new Date(entry.lastModified) : undefined,
+    changeFrequency: entry.changeFrequency,
+    priority: entry.priority,
+  }));
+}
+`;
+};

package/dist/templates/env.example.d.ts

@@ -1 +1 @@
-export declare const envExampleTemplate = "# LLM Provider Configuration\n# Choose your preferred LLM provider: openai, anthropic, or google\nLLM_PROVIDER=openai\n\n# API Keys (set the one matching your provider)\nOPENAI_API_KEY=your_openai_api_key_here\nANTHROPIC_API_KEY=your_anthropic_api_key_here\nGOOGLE_API_KEY=your_google_api_key_here\n\n# Optional: Override default chat model\n# See available models at your provider's docs:\n#   OpenAI:    https://platform.openai.com/docs/models\n#   Anthropic: https://docs.anthropic.com/claude/docs/models-overview\n#   Google:    https://ai.google.dev/models/gemini\n# LLM_CHAT_MODEL=\n\n# Optional: Override default embedding model\n# See available embedding models at your provider's docs:\n#   OpenAI: https://platform.openai.com/docs/guides/embeddings\n#   Google: https://ai.google.dev/gemini-api/docs/embeddings\n# Note: Anthropic doesn't provide embeddings, will fallback to OpenAI\n# LLM_EMBEDDING_MODEL=\n\n# Optional: Set temperature (0-1, default: 0)\n# LLM_TEMPERATURE=0\n";
+export declare const envExampleTemplate = "# Public Site URL\n# Used by sitemap.xml and robots.txt. Overrides `url` in config.json when set.\n# NEXT_PUBLIC_SITE_URL=https://docs.example.com\n\n# LLM Provider Configuration\n# Choose your preferred LLM provider: openai, anthropic, or google\nLLM_PROVIDER=openai\n\n# API Keys (set the one matching your provider)\nOPENAI_API_KEY=your_openai_api_key_here\nANTHROPIC_API_KEY=your_anthropic_api_key_here\nGOOGLE_API_KEY=your_google_api_key_here\n\n# Optional: Override default chat model\n# See available models at your provider's docs:\n#   OpenAI:    https://platform.openai.com/docs/models\n#   Anthropic: https://docs.anthropic.com/claude/docs/models-overview\n#   Google:    https://ai.google.dev/models/gemini\n# LLM_CHAT_MODEL=\n\n# Optional: Override default embedding model\n# See available embedding models at your provider's docs:\n#   OpenAI: https://platform.openai.com/docs/guides/embeddings\n#   Google: https://ai.google.dev/gemini-api/docs/embeddings\n# Note: Anthropic doesn't provide embeddings, will fallback to OpenAI\n# LLM_EMBEDDING_MODEL=\n\n# Optional: Set temperature (0-1, default: 0)\n# LLM_TEMPERATURE=0\n";

package/dist/templates/env.example.js

@@ -1,4 +1,8 @@
-export const envExampleTemplate = `# LLM Provider Configuration
+export const envExampleTemplate = `# Public Site URL
+# Used by sitemap.xml and robots.txt. Overrides \`url\` in config.json when set.
+# NEXT_PUBLIC_SITE_URL=https://docs.example.com
+
+# LLM Provider Configuration
 # Choose your preferred LLM provider: openai, anthropic, or google
 LLM_PROVIDER=openai
 

package/dist/templates/mdx/deployment-and-hosting.mdx.d.ts

@@ -1 +1 @@
-export declare const deploymentAndHostingMdxTemplate = "---\ntitle: \"Deployment & Hosting\"\ndescription: \"Deploy your documentation site with the Doccupine Platform or self-host on any platform that supports Next.js.\"\ndate: \"2026-02-19\"\ncategory: \"Configuration\"\ncategoryOrder: 3\norder: 11\n---\n# Deployment & Hosting\nThe fastest way to deploy your documentation is with the [Doccupine Platform](https://www.doccupine.com). If you prefer to manage your own infrastructure, you can self-host the generated Next.js app on any platform.\n\n## Doccupine Platform\n\nSign up at [doccupine.com](https://www.doccupine.com) and connect your repository. Your documentation site is live in minutes - no build configuration, no infrastructure to manage.\n\n<Callout type=\"success\">\n  The Doccupine Platform is the recommended way to deploy. It handles builds, hosting, SSL, and updates automatically so you can focus on writing documentation.\n</Callout>\n\n### What you get\n- **Automatic deployments** on every push to your repository\n- **Site customization** through a visual dashboard - no code changes needed\n- **Team collaboration** so your whole team can manage docs together\n- **Custom domains** with automatic SSL\n- **AI Assistant and MCP server** included out of the box, no API key required\n- **Zero maintenance** - no servers, no build pipelines, no dependency updates\n\n### Getting started\n1. Create an account at [doccupine.com](https://www.doccupine.com).\n2. Connect your GitHub repository.\n3. Your site is deployed automatically.\n\nEvery push to your repository triggers a new deployment. You can customize your site's appearance, domain, and settings from the dashboard. See the [Platform Overview](/platform) for a full walkthrough of the dashboard, editor, and configuration options.\n\n---\n\n## Self-hosting\n\nDoccupine generates a standard Next.js app, so you can deploy it anywhere that supports Node.js or Next.js.\n\n<Callout type=\"warning\">\n  Deploy the generated website directory (the Next.js app), not your MDX source folder. In a monorepo, set the root directory to the generated site folder.\n</Callout>\n\n<Callout type=\"note\">\n  Self-hosting requires you to manage your own build pipeline, hosting, SSL certificates, and AI provider API keys. For a hands-off experience, consider the [Doccupine Platform](https://www.doccupine.com).\n</Callout>\n\n### Popular hosting options\n\n- **Vercel** - native Next.js support, zero-config deploys. Connect your repo and set the root directory to the generated app folder.\n- **Netlify** - supports Next.js via the `@netlify/plugin-nextjs` adapter. Works with the standard `next build` output.\n- **AWS Amplify** - fully managed hosting with CI/CD. Supports Next.js SSR out of the box.\n- **Cloudflare Pages** - deploy using the `@cloudflare/next-on-pages` adapter for edge-based hosting.\n- **Docker** - build a container from the generated app using the standard [Next.js Docker example](https://github.com/vercel/next.js/tree/canary/examples/with-docker) and deploy to any container platform.\n- **Node.js server** - run `next build && next start` on any server or VPS with Node.js installed.\n\n### Troubleshooting\n- **Build failed** - check build logs. Ensure your lockfile and correct Node.js version are present.\n- **Missing content** - verify your MDX files and assets are in the repository.\n- **SSR issues on edge platforms** - some features (like the AI chat API routes) require a Node.js runtime. Check your platform's documentation for SSR/API route support.";
+export declare const deploymentAndHostingMdxTemplate = "---\ntitle: \"Deployment & Hosting\"\ndescription: \"Deploy your documentation site with the Doccupine Platform or self-host on any platform that supports Next.js.\"\ndate: \"2026-02-19\"\ncategory: \"Configuration\"\ncategoryOrder: 3\norder: 11\n---\n# Deployment & Hosting\nThe fastest way to deploy your documentation is with the [Doccupine Platform](https://www.doccupine.com). If you prefer to manage your own infrastructure, you can self-host the generated Next.js app on any platform.\n\n## Doccupine Platform\n\nSign up at [doccupine.com](https://www.doccupine.com) and connect your repository. Your documentation site is live in minutes - no build configuration, no infrastructure to manage.\n\n<Callout type=\"success\">\n  The Doccupine Platform is the recommended way to deploy. It handles builds, hosting, SSL, and updates automatically so you can focus on writing documentation.\n</Callout>\n\n### What you get\n- **Automatic deployments** on every push to your repository\n- **Site customization** through a visual dashboard - no code changes needed\n- **Team collaboration** so your whole team can manage docs together\n- **Custom domains** with automatic SSL\n- **AI Assistant and MCP server** included out of the box, no API key required\n- **Zero maintenance** - no servers, no build pipelines, no dependency updates\n\n### Getting started\n1. Create an account at [doccupine.com](https://www.doccupine.com).\n2. Connect your GitHub repository.\n3. Your site is deployed automatically.\n\nEvery push to your repository triggers a new deployment. You can customize your site's appearance, domain, and settings from the dashboard. See the [Platform Overview](/platform) for a full walkthrough of the dashboard, editor, and configuration options.\n\n---\n\n## Self-hosting\n\nDoccupine generates a standard Next.js app, so you can deploy it anywhere that supports Node.js or Next.js.\n\n<Callout type=\"warning\">\n  Deploy the generated website directory (the Next.js app), not your MDX source folder. In a monorepo, set the root directory to the generated site folder.\n</Callout>\n\n<Callout type=\"note\">\n  Self-hosting requires you to manage your own build pipeline, hosting, SSL certificates, and AI provider API keys. For a hands-off experience, consider the [Doccupine Platform](https://www.doccupine.com).\n</Callout>\n\n### Popular hosting options\n\n- **Vercel** - native Next.js support, zero-config deploys. Connect your repo and set the root directory to the generated app folder.\n- **Netlify** - supports Next.js via the `@netlify/plugin-nextjs` adapter. Works with the standard `next build` output.\n- **AWS Amplify** - fully managed hosting with CI/CD. Supports Next.js SSR out of the box.\n- **Cloudflare Pages** - deploy using the `@cloudflare/next-on-pages` adapter for edge-based hosting.\n- **Docker** - build a container from the generated app using the standard [Next.js Docker example](https://github.com/vercel/next.js/tree/canary/examples/with-docker) and deploy to any container platform.\n- **Node.js server** - run `next build && next start` on any server or VPS with Node.js installed.\n\n### Sitemap and robots.txt\nDoccupine generates `sitemap.xml` and `robots.txt` automatically when you set a site URL. This is required for search engine indexing and is strongly recommended for any public deployment.\n\nSet the URL in `config.json`:\n\n```json\n{\n  \"url\": \"https://docs.example.com\"\n}\n```\n\nAt deploy time, you can override the value with the `NEXT_PUBLIC_SITE_URL` environment variable - useful for preview deployments or staging environments.\n\n```bash\nNEXT_PUBLIC_SITE_URL=https://staging.example.com\n```\n\nThe generated sitemap includes every page from every [section](/sections), with `lastModified` derived from each page's frontmatter `date` or the file's modification time. When no URL is configured, the sitemap is skipped and `robots.txt` is emitted without a sitemap reference.\n\n### Troubleshooting\n- **Build failed** - check build logs. Ensure your lockfile and correct Node.js version are present.\n- **Missing content** - verify your MDX files and assets are in the repository.\n- **SSR issues on edge platforms** - some features (like the AI chat API routes) require a Node.js runtime. Check your platform's documentation for SSR/API route support.";

package/dist/templates/mdx/deployment-and-hosting.mdx.js

@@ -55,6 +55,25 @@ Doccupine generates a standard Next.js app, so you can deploy it anywhere that s
 - **Docker** - build a container from the generated app using the standard [Next.js Docker example](https://github.com/vercel/next.js/tree/canary/examples/with-docker) and deploy to any container platform.
 - **Node.js server** - run \`next build && next start\` on any server or VPS with Node.js installed.
 
+### Sitemap and robots.txt
+Doccupine generates \`sitemap.xml\` and \`robots.txt\` automatically when you set a site URL. This is required for search engine indexing and is strongly recommended for any public deployment.
+
+Set the URL in \`config.json\`:
+
+\`\`\`json
+{
+  "url": "https://docs.example.com"
+}
+\`\`\`
+
+At deploy time, you can override the value with the \`NEXT_PUBLIC_SITE_URL\` environment variable - useful for preview deployments or staging environments.
+
+\`\`\`bash
+NEXT_PUBLIC_SITE_URL=https://staging.example.com
+\`\`\`
+
+The generated sitemap includes every page from every [section](/sections), with \`lastModified\` derived from each page's frontmatter \`date\` or the file's modification time. When no URL is configured, the sitemap is skipped and \`robots.txt\` is emitted without a sitemap reference.
+
 ### Troubleshooting
 - **Build failed** - check build logs. Ensure your lockfile and correct Node.js version are present.
 - **Missing content** - verify your MDX files and assets are in the repository.

package/dist/templates/mdx/globals.mdx.d.ts

@@ -1 +1 @@
-export declare const globalsMdxTemplate = "---\ntitle: \"Globals\"\ndescription: \"Configure global settings for your documentation.\"\ndate: \"2026-02-19\"\ncategory: \"Configuration\"\ncategoryOrder: 3\norder: 1\n---\n# Global Configuration\nUse a `config.json` file to define project\u2011wide metadata for your documentation site. These values are applied to every generated page unless a page overrides them in its own frontmatter.\n\n## config.json\nPlace a `config.json` at your project root (the same folder where you execute `npx doccupine`) to define global metadata for your documentation site.\n\n```json\n{\n  \"name\": \"Doccupine\",\n  \"description\": \"Doccupine is a free and open-source documentation platform. Write MDX, get a production-ready site with AI chat, built-in components, and an MCP server - in one command.\",\n  \"icon\": \"https://docs.doccupine.com/favicon.ico\",\n  \"image\": \"https://docs.doccupine.com/preview.png\"\n}\n```\n\n## Fields\nAll fields are optional. Doccupine uses sensible defaults when a field is not set.\n\n- **name**: The primary name of your documentation website. Displayed in the site title and used in various UI elements.\n- **description**: A concise summary of your project, used in site metadata (e.g., HTML meta description) and social previews when not overridden.\n- **icon**: The favicon for your site. You can provide a full URL or a relative path to an asset in your project.\n- **image**: The Open Graph image used when links to your docs are shared on social platforms. Accepts a full URL or a relative path.\n\n## Per-page overrides\nAny page can override global values by defining the matching key in its frontmatter. When present, the page's value takes precedence over `config.json` for that page only.\n\n| Frontmatter field | Overrides | Effect |\n|---|---|---|\n| **title** | - | Page title in metadata and Open Graph |\n| **description** | `description` | Meta description and Open Graph description |\n| **name** | `name` | Site name shown in the title suffix (e.g. \"Page - My Docs\") |\n| **icon** | `icon` | Favicon for this page |\n| **image** | `image` | Open Graph preview image |\n| **section** | - | Assigns the page to a [section](/sections) |\n| **sectionOrder** | - | Controls section position in the tab bar |\n| **sectionLabel** | - | Renames the default \"Docs\" tab (use on `index.mdx`) |\n\n<Callout type=\"note\">\n  If a key is not specified in a page's frontmatter, Doccupine falls back to the corresponding value in `config.json`.\n</Callout>\n\nExample frontmatter in an `.mdx` file:\n\n```text\n---\ntitle: \"My Feature\"\ndescription: \"A focused description just for this page.\"\nname: \"My Product Docs\"\nicon: \"/custom-favicon.ico\"\nimage: \"/custom-preview.png\"\ndate: \"2026-02-19\"\ncategory: \"Guides\"\n---\n```\n\n";
+export declare const globalsMdxTemplate = "---\ntitle: \"Globals\"\ndescription: \"Configure global settings for your documentation.\"\ndate: \"2026-02-19\"\ncategory: \"Configuration\"\ncategoryOrder: 3\norder: 1\n---\n# Global Configuration\nUse a `config.json` file to define project\u2011wide metadata for your documentation site. These values are applied to every generated page unless a page overrides them in its own frontmatter.\n\n## config.json\nPlace a `config.json` at your project root (the same folder where you execute `npx doccupine`) to define global metadata for your documentation site.\n\n```json\n{\n  \"name\": \"Doccupine\",\n  \"description\": \"Doccupine is a free and open-source documentation platform. Write MDX, get a production-ready site with AI chat, built-in components, and an MCP server - in one command.\",\n  \"icon\": \"https://docs.doccupine.com/favicon.ico\",\n  \"image\": \"https://docs.doccupine.com/preview.png\",\n  \"url\": \"https://docs.example.com\"\n}\n```\n\n## Fields\nAll fields are optional. Doccupine uses sensible defaults when a field is not set.\n\n- **name**: The primary name of your documentation website. Displayed in the site title and used in various UI elements.\n- **description**: A concise summary of your project, used in site metadata (e.g., HTML meta description) and social previews when not overridden.\n- **icon**: The favicon for your site. You can provide a full URL or a relative path to an asset in your project.\n- **image**: The Open Graph image used when links to your docs are shared on social platforms. Accepts a full URL or a relative path.\n- **url**: The public URL of your deployed site. Used as the base URL for `sitemap.xml` and `robots.txt`. When omitted, no sitemap is generated. Can be overridden at deploy time with the `NEXT_PUBLIC_SITE_URL` environment variable.\n\n## Per-page overrides\nAny page can override global values by defining the matching key in its frontmatter. When present, the page's value takes precedence over `config.json` for that page only.\n\n| Frontmatter field | Overrides | Effect |\n|---|---|---|\n| **title** | - | Page title in metadata and Open Graph |\n| **description** | `description` | Meta description and Open Graph description |\n| **name** | `name` | Site name shown in the title suffix (e.g. \"Page - My Docs\") |\n| **icon** | `icon` | Favicon for this page |\n| **image** | `image` | Open Graph preview image |\n| **section** | - | Assigns the page to a [section](/sections) |\n| **sectionOrder** | - | Controls section position in the tab bar |\n| **sectionLabel** | - | Renames the default \"Docs\" tab (use on `index.mdx`) |\n\n<Callout type=\"note\">\n  If a key is not specified in a page's frontmatter, Doccupine falls back to the corresponding value in `config.json`.\n</Callout>\n\nExample frontmatter in an `.mdx` file:\n\n```text\n---\ntitle: \"My Feature\"\ndescription: \"A focused description just for this page.\"\nname: \"My Product Docs\"\nicon: \"/custom-favicon.ico\"\nimage: \"/custom-preview.png\"\ndate: \"2026-02-19\"\ncategory: \"Guides\"\n---\n```\n\n";

package/dist/templates/mdx/globals.mdx.js

@@ -18,7 +18,8 @@ Place a \`config.json\` at your project root (the same folder where you execute
   "name": "Doccupine",
   "description": "${DEFAULT_DESCRIPTION}",
   "icon": "${DEFAULT_FAVICON}",
-  "image": "${DEFAULT_OG_IMAGE}"
+  "image": "${DEFAULT_OG_IMAGE}",
+  "url": "https://docs.example.com"
 }
 \`\`\`
 
@@ -29,6 +30,7 @@ All fields are optional. Doccupine uses sensible defaults when a field is not se
 - **description**: A concise summary of your project, used in site metadata (e.g., HTML meta description) and social previews when not overridden.
 - **icon**: The favicon for your site. You can provide a full URL or a relative path to an asset in your project.
 - **image**: The Open Graph image used when links to your docs are shared on social platforms. Accepts a full URL or a relative path.
+- **url**: The public URL of your deployed site. Used as the base URL for \`sitemap.xml\` and \`robots.txt\`. When omitted, no sitemap is generated. Can be overridden at deploy time with the \`NEXT_PUBLIC_SITE_URL\` environment variable.
 
 ## Per-page overrides
 Any page can override global values by defining the matching key in its frontmatter. When present, the page's value takes precedence over \`config.json\` for that page only.

package/dist/templates/package.js

@@ -10,29 +10,29 @@ export const packageJsonTemplate = JSON.stringify({
         format: "prettier --write .",
     },
     dependencies: {
-        "@langchain/anthropic": "^1.3.26",
-        "@langchain/core": "^1.1.38",
-        "@langchain/google-genai": "^2.1.26",
-        "@langchain/openai": "^1.4.1",
+        "@langchain/anthropic": "^1.3.27",
+        "@langchain/core": "^1.1.41",
+        "@langchain/google-genai": "^2.1.28",
+        "@langchain/openai": "^1.4.4",
         "@mdx-js/react": "^3.1.1",
         "@modelcontextprotocol/sdk": "^1.29.0",
-        "@posthog/react": "^1.8.2",
-        "cherry-styled-components": "^0.1.16",
-        langchain: "^1.2.39",
-        "lucide-react": "^1.7.0",
+        "@posthog/react": "^1.9.0",
+        "cherry-styled-components": "^0.1.17",
+        langchain: "^1.3.4",
+        "lucide-react": "^1.9.0",
         minisearch: "^7.2.0",
-        next: "16.2.2",
+        next: "16.2.4",
         "next-mdx-remote": "^6.0.0",
         polished: "^4.3.1",
-        "posthog-js": "^1.364.4",
-        "posthog-node": "^5.28.9",
-        react: "19.2.4",
-        "react-dom": "19.2.4",
+        "posthog-js": "^1.371.2",
+        "posthog-node": "^5.30.0",
+        react: "19.2.5",
+        "react-dom": "19.2.5",
         "rehype-highlight": "^7.0.2",
         "rehype-parse": "^9.0.1",
         "rehype-stringify": "^10.0.1",
         "remark-gfm": "^4.0.1",
-        "styled-components": "^6.3.12",
+        "styled-components": "^6.4.1",
         unified: "^11.0.5",
         zod: "^4.3.6",
     },
@@ -40,10 +40,10 @@ export const packageJsonTemplate = JSON.stringify({
         "@types/node": "^25",
         "@types/react": "^19",
         "@types/react-dom": "^19",
-        "baseline-browser-mapping": "^2.10.13",
+        "baseline-browser-mapping": "^2.10.21",
         eslint: "^9",
-        "eslint-config-next": "16.2.2",
-        prettier: "^3.8.1",
+        "eslint-config-next": "16.2.4",
+        prettier: "^3.8.3",
         typescript: "^6",
     },
 }, null, 2) + "\n";

package/dist/templates/utils/config.d.ts

@@ -1 +1 @@
-export declare const configTemplate = "import { z } from \"zod\";\nimport configData from \"@/config.json\";\n\nconst configSchema = z.object({\n  name: z.string().optional(),\n  description: z.string().optional(),\n  icon: z.string().optional(),\n  image: z.string().optional(),\n});\n\ntype Config = z.infer<typeof configSchema>;\n\nexport const config: Config = configSchema.parse(configData);\n";
+export declare const configTemplate = "import { z } from \"zod\";\nimport configData from \"@/config.json\";\n\nconst configSchema = z.object({\n  name: z.string().optional(),\n  description: z.string().optional(),\n  icon: z.string().optional(),\n  image: z.string().optional(),\n  url: z.string().url().optional(),\n});\n\ntype Config = z.infer<typeof configSchema>;\n\nexport const config: Config = configSchema.parse(configData);\n";

package/dist/templates/utils/config.js

@@ -6,6 +6,7 @@ const configSchema = z.object({
   description: z.string().optional(),
   icon: z.string().optional(),
   image: z.string().optional(),
+  url: z.string().url().optional(),
 });
 
 type Config = z.infer<typeof configSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "doccupine",
-  "version": "0.0.87",
+  "version": "0.0.88",
   "description": "Free and open-source documentation platform. Write MDX, get a production-ready site with AI chat, built-in components, and an MCP server - in one command.",
   "main": "dist/index.js",
   "bin": {
@@ -39,19 +39,19 @@
     "commander": "^14.0.3",
     "fs-extra": "^11.3.4",
     "gray-matter": "^4.0.3",
-    "next": "^16.2.2",
+    "next": "^16.2.4",
     "prompts": "^2.4.2",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4"
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5"
   },
   "devDependencies": {
     "@types/chokidar": "^2.1.7",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^25.5.0",
+    "@types/node": "^25.6.0",
     "@types/prompts": "^2.4.9",
-    "prettier": "^3.8.1",
-    "typescript": "^6.0.2",
-    "vitest": "^4.1.2"
+    "prettier": "^3.8.3",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
   },
   "files": [
     "dist/**/*"