doccupine 0.0.62 → 0.0.64

package/README.md

@@ -18,7 +18,7 @@
 
 ## Quick Start
 
-Make sure you have [Node.js](https://nodejs.org) (v18+) installed.
+Make sure you have [Node.js](https://nodejs.org) (v22+) installed.
 
 ```bash
 npx doccupine
@@ -59,6 +59,7 @@ description: "Page description for SEO"
 category: "Getting Started"
 categoryOrder: 0 # Sort order for the category group
 order: 1 # Sort order within the category
+name: "My Docs" # Override site name in title suffix
 icon: "https://..." # Page favicon URL
 image: "https://..." # OpenGraph image URL
 date: "2025-01-01" # Page date metadata
@@ -128,7 +129,7 @@ Place these JSON files in your project root (where you run `doccupine`). They ar
 | File              | Purpose                                                                                                   |
 | ----------------- | --------------------------------------------------------------------------------------------------------- |
 | `doccupine.json`  | CLI config (watchDir, outputDir, port). Auto-generated on first run.                                      |
-| `config.json`     | Site metadata: `name`, `description`, `icon`, `preview` image URL                                         |
+| `config.json`     | Site metadata: `name`, `description`, `icon`, `image` URL                                                 |
 | `theme.json`      | Theme overrides for [cherry-styled-components](https://github.com/cherry-design-system/styled-components) |
 | `navigation.json` | Manual navigation structure (overrides auto-generated)                                                    |
 | `links.json`      | Static header/footer links                                                                                |
@@ -141,7 +142,7 @@ Place static assets (images, favicons, `robots.txt`, etc.) in a `public/` direct
 
 ## AI Chat Setup
 
-The generated app includes an AI chat assistant. To enable it, create a `.env.local` file in the generated app directory:
+The generated app includes an AI chat assistant. To enable it, create a `.env` file in the generated app directory:
 
 ```env
 LLM_PROVIDER=openai # openai | anthropic | google
@@ -170,7 +171,7 @@ Default models per provider:
 | --------- | ---------------------------- | ------------------------ |
 | OpenAI    | `gpt-4.1-nano`               | `text-embedding-3-small` |
 | Anthropic | `claude-sonnet-4-5-20250929` | OpenAI fallback          |
-| Google    | `gemini-2.5-flash-lite`      | `text-embedding-004`     |
+| Google    | `gemini-2.5-flash-lite`      | `gemini-embedding-001`   |
 
 ## MCP Server
 

package/dist/index.d.ts

@@ -1,4 +1,2 @@
 #!/usr/bin/env node
-export declare function generateSlug(filePath: string): string;
-export declare function getFullSlug(pageSlug: string, sectionSlug: string): string;
-export declare function escapeTemplateContent(content: string): string;
+export { generateSlug, getFullSlug, escapeTemplateContent, } from "./lib/utils.js";

package/dist/index.js

@@ -6,209 +6,16 @@ import path from "path";
 import { fileURLToPath } from "url";
 import matter from "gray-matter";
 import chalk from "chalk";
-import prompts from "prompts";
-import { envExampleTemplate } from "./templates/env.example.js";
-import { gitignoreTemplate } from "./templates/gitignore.js";
-import { eslintConfigTemplate } from "./templates/eslint.config.js";
-import { nextConfigTemplate } from "./templates/next.config.js";
-import { packageJsonTemplate } from "./templates/package.js";
-import { prettierrcTemplate } from "./templates/prettierrc.js";
-import { prettierignoreTemplate } from "./templates/prettierignore.js";
-import { proxyTemplate } from "./templates/proxy.js";
-import { tsconfigTemplate } from "./templates/tsconfig.js";
-import { mcpRoutesTemplate } from "./templates/app/api/mcp/route.js";
-import { ragRoutesTemplate } from "./templates/app/api/rag/route.js";
-import { routesTemplate } from "./templates/app/api/theme/routes.js";
-import { layoutTemplate } from "./templates/app/layout.js";
-import { notFoundTemplate } from "./templates/app/not-found.js";
-import { themeTemplate } from "./templates/app/theme.js";
-import { chatTemplate } from "./templates/components/Chat.js";
-import { clickOutsideTemplate } from "./templates/components/ClickOutside.js";
-import { docsTemplate } from "./templates/components/Docs.js";
-import { docsSideBarTemplate } from "./templates/components/DocsSideBar.js";
-import { mdxComponentsTemplate } from "./templates/components/MDXComponents.js";
-import { sectionNavProviderTemplate } from "./templates/components/SectionNavProvider.js";
-import { sideBarTemplate } from "./templates/components/SideBar.js";
-import { sectionBarTemplate } from "./templates/components/layout/SectionBar.js";
-import { accordionTemplate } from "./templates/components/layout/Accordion.js";
-import { actionBarTemplate } from "./templates/components/layout/ActionBar.js";
-import { buttonTemplate } from "./templates/components/layout/Button.js";
-import { calloutTemplate } from "./templates/components/layout/Callout.js";
-import { cardTemplate } from "./templates/components/layout/Card.js";
-import { cherryThemeProviderTemplate } from "./templates/components/layout/CherryThemeProvider.js";
-import { clientThemeProviderTemplate } from "./templates/components/layout/ClientThemeProvider.js";
-import { codeTemplate } from "./templates/components/layout/Code.js";
-import { columnsTemplate } from "./templates/components/layout/Columns.js";
-import { demoThemeTemplate } from "./templates/components/layout/DemoTheme.js";
-import { docsComponentsTemplate } from "./templates/components/layout/DocsComponents.js";
-import { docsNavigationTemplate } from "./templates/components/layout/DocsNavigation.js";
-import { fieldTemplate } from "./templates/components/layout/Field.js";
-import { footerTemplate } from "./templates/components/layout/Footer.js";
-import { globalStylesTemplate } from "./templates/components/layout/GlobalStyles.js";
-import { headerTemplate } from "./templates/components/layout/Header.js";
-import { iconTemplate } from "./templates/components/layout/Icon.js";
-import { pictogramsTemplate } from "./templates/components/layout/Pictograms.js";
-import { sharedStyledTemplate } from "./templates/components/layout/SharedStyles.js";
-import { staticLinksTemplate } from "./templates/components/layout/StaticLinks.js";
-import { stepsTemplate } from "./templates/components/layout/Steps.js";
-import { tabsTemplate } from "./templates/components/layout/Tabs.js";
-import { themeToggleTemplate } from "./templates/components/layout/ThemeToggle.js";
-import { typographyTemplate } from "./templates/components/layout/Typography.js";
-import { updateTemplate } from "./templates/components/layout/Update.js";
-import { mcpIndexTemplate } from "./templates/services/mcp/index.js";
-import { mcpServerTemplate } from "./templates/services/mcp/server.js";
-import { mcpToolsTemplate } from "./templates/services/mcp/tools.js";
-import { mcpTypesTemplate } from "./templates/services/mcp/types.js";
-import { llmConfigTemplate } from "./templates/services/llm/config.js";
-import { llmFactoryTemplate } from "./templates/services/llm/factory.js";
-import { llmIndexTemplate } from "./templates/services/llm/index.js";
-import { llmTypesTemplate } from "./templates/services/llm/types.js";
-import { styledDTemplate } from "./templates/types/styled.js";
-import { orderNavItemsTemplate } from "./templates/utils/orderNavItems.js";
-import { rateLimitTemplate } from "./templates/utils/rateLimit.js";
-import { brandingTemplate } from "./templates/utils/branding.js";
-import { configTemplate } from "./templates/utils/config.js";
-import { accordionMdxTemplate } from "./templates/mdx/accordion.mdx.js";
-import { aiAssistantMdxTemplate } from "./templates/mdx/ai-assistant.mdx.js";
-import { buttonsMdxTemplate } from "./templates/mdx/buttons.mdx.js";
-import { calloutsMdxTemplate } from "./templates/mdx/callouts.mdx.js";
-import { cardsMdxTemplate } from "./templates/mdx/cards.mdx.js";
-import { codeMdxTemplate } from "./templates/mdx/code.mdx.js";
-import { columnsMdxTemplate } from "./templates/mdx/columns.mdx.js";
-import { commandsMdxTemplate } from "./templates/mdx/commands.mdx.js";
-import { deploymentMdxTemplate } from "./templates/mdx/deployment.mdx.js";
-import { fieldsMdxTemplate } from "./templates/mdx/fields.mdx.js";
-import { fontsMdxTemplate } from "./templates/mdx/fonts.mdx.js";
-import { globalsMdxTemplate } from "./templates/mdx/globals.mdx.js";
-import { headersAndTextMdxTemplate } from "./templates/mdx/headers-and-text.mdx.js";
-import { iconsMdxTemplate } from "./templates/mdx/icons.mdx.js";
-import { imageAndEmbedsMdxTemplate } from "./templates/mdx/image-and-embeds.mdx.js";
-import { indexMdxTemplate } from "./templates/mdx/index.mdx.js";
-import { footerLinksMdxTemplate } from "./templates/mdx/footer-links.mdx.js";
-import { listAndTablesMdxTemplate } from "./templates/mdx/list-and-tables.mdx.js";
-import { mediaAndAssetsMdxTemplate } from "./templates/mdx/media-and-assets.mdx.js";
-import { mcpMdxTemplate } from "./templates/mdx/model-context-protocol.mdx.js";
-import { navigationMdxTemplate } from "./templates/mdx/navigation.mdx.js";
-import { sectionsMdxTemplate } from "./templates/mdx/sections.mdx.js";
-import { stepsMdxTemplate } from "./templates/mdx/steps.mdx.js";
-import { tabsMdxTemplate } from "./templates/mdx/tabs.mdx.js";
-import { themeMdxTemplate } from "./templates/mdx/theme.mdx.js";
-import { updateMdxTemplate } from "./templates/mdx/update.mdx.js";
-async function findAvailablePort(startPort) {
-    const net = await import("net");
-    return new Promise((resolve) => {
-        const server = net.createServer();
-        server.listen(startPort, () => {
-            server.close(() => resolve(startPort));
-        });
-        server.on("error", () => {
-            resolve(findAvailablePort(startPort + 1));
-        });
-    });
-}
-export function generateSlug(filePath) {
-    if (filePath === "index.mdx" || filePath === "./index.mdx") {
-        return "";
-    }
-    const normalized = filePath
-        .replace(/\.mdx$/, "")
-        .replace(/\\/g, "/")
-        .replace(/[^a-zA-Z0-9\/\-_]/g, "-")
-        .toLowerCase();
-    // Strip trailing /index for subdirectory index files
-    if (normalized.endsWith("/index")) {
-        return normalized.slice(0, -"/index".length);
-    }
-    return normalized;
-}
-export function getFullSlug(pageSlug, sectionSlug) {
-    if (!sectionSlug)
-        return pageSlug;
-    if (pageSlug === "")
-        return sectionSlug;
-    return `${sectionSlug}/${pageSlug}`;
-}
-export function escapeTemplateContent(content) {
-    return content
-        .replace(/\\/g, "\\\\")
-        .replace(/`/g, "\\`")
-        .replace(/\$\{/g, "\\${");
-}
+import { appStructure, startingDocsStructure } from "./lib/structures.js";
+import { layoutTemplate } from "./lib/layout.js";
+import { ConfigManager } from "./lib/config-manager.js";
+import { findAvailablePort, generateSlug, getFullSlug, escapeTemplateContent, } from "./lib/utils.js";
+import { generateMetadataBlock, generateRuntimeOnlyMetadataBlock, } from "./lib/metadata.js";
+export { generateSlug, getFullSlug, escapeTemplateContent, } from "./lib/utils.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf8"));
 const version = packageJson.version;
-class ConfigManager {
-    configPath;
-    constructor(configPath = "doccupine.json") {
-        this.configPath = path.resolve(process.cwd(), configPath);
-    }
-    async loadConfig() {
-        try {
-            if (await fs.pathExists(this.configPath)) {
-                const configContent = await fs.readFile(this.configPath, "utf8");
-                const config = JSON.parse(configContent);
-                console.log(chalk.blue("📄 Using existing configuration from doccupine.json"));
-                return config;
-            }
-        }
-        catch (error) {
-            console.warn(chalk.yellow("⚠️ Error reading config file, will create new one"));
-        }
-        return null;
-    }
-    async saveConfig(config) {
-        try {
-            await fs.writeFile(this.configPath, JSON.stringify(config, null, 2), "utf8");
-            console.log(chalk.green("💾 Configuration saved to doccupine.json"));
-        }
-        catch (error) {
-            console.error(chalk.red("❌ Error saving config file:"), error);
-        }
-    }
-    async promptForConfig(existingConfig) {
-        const questions = [
-            {
-                type: "text",
-                name: "watchDir",
-                message: "Enter directory to watch for MDX files:",
-                initial: existingConfig?.watchDir || "docs",
-            },
-            {
-                type: "text",
-                name: "outputDir",
-                message: "Enter output directory for Next.js app:",
-                initial: existingConfig?.outputDir || "nextjs-app",
-            },
-        ];
-        const { watchDir, outputDir } = (await prompts(questions));
-        if (!watchDir || !outputDir) {
-            console.log(chalk.yellow("\n⚠️ Setup cancelled."));
-            process.exit(0);
-        }
-        return {
-            watchDir: path.resolve(process.cwd(), watchDir),
-            outputDir: path.resolve(process.cwd(), outputDir),
-            port: existingConfig?.port || "3000",
-        };
-    }
-    async getConfig(options = {}) {
-        let config = null;
-        if (!options.reset) {
-            config = await this.loadConfig();
-        }
-        if (!config || options.reset) {
-            console.log(chalk.blue("🔧 Setting up Doccupine configuration..."));
-            config = await this.promptForConfig(config || {});
-            await this.saveConfig(config);
-        }
-        if (options.port) {
-            config.port = options.port;
-            await this.saveConfig(config);
-        }
-        return config;
-    }
-}
 class MDXToNextJSGenerator {
     watchDir;
     outputDir;
@@ -255,72 +62,13 @@ class MDXToNextJSGenerator {
     }
     async createNextJSStructure() {
         const structure = {
-            ".env.example": envExampleTemplate,
-            ".gitignore": gitignoreTemplate,
-            ".prettierrc": prettierrcTemplate,
-            ".prettierignore": prettierignoreTemplate,
+            ...appStructure,
             "config.json": `{}\n`,
-            "eslint.config.mjs": eslintConfigTemplate,
             "links.json": `[]\n`,
             "navigation.json": `[]\n`,
             "sections.json": `[]\n`,
-            "next.config.ts": nextConfigTemplate,
-            "package.json": packageJsonTemplate,
-            "proxy.ts": proxyTemplate,
             "theme.json": `{}\n`,
-            "tsconfig.json": tsconfigTemplate,
             "app/layout.tsx": this.generateRootLayout(),
-            "app/not-found.tsx": notFoundTemplate,
-            "app/theme.ts": themeTemplate,
-            "app/api/mcp/route.ts": mcpRoutesTemplate,
-            "app/api/rag/route.ts": ragRoutesTemplate,
-            "app/api/theme/route.ts": routesTemplate,
-            "services/mcp/index.ts": mcpIndexTemplate,
-            "services/mcp/server.ts": mcpServerTemplate,
-            "services/mcp/tools.ts": mcpToolsTemplate,
-            "services/mcp/types.ts": mcpTypesTemplate,
-            "services/llm/config.ts": llmConfigTemplate,
-            "services/llm/factory.ts": llmFactoryTemplate,
-            "services/llm/index.ts": llmIndexTemplate,
-            "services/llm/types.ts": llmTypesTemplate,
-            "types/styled.d.ts": styledDTemplate,
-            "utils/branding.ts": brandingTemplate,
-            "utils/orderNavItems.ts": orderNavItemsTemplate,
-            "utils/rateLimit.ts": rateLimitTemplate,
-            "utils/config.ts": configTemplate,
-            "components/Chat.tsx": chatTemplate,
-            "components/ClickOutside.ts": clickOutsideTemplate,
-            "components/Docs.tsx": docsTemplate,
-            "components/DocsSideBar.tsx": docsSideBarTemplate,
-            "components/MDXComponents.tsx": mdxComponentsTemplate,
-            "components/SectionNavProvider.tsx": sectionNavProviderTemplate,
-            "components/SideBar.tsx": sideBarTemplate,
-            "components/layout/Accordion.tsx": accordionTemplate,
-            "components/layout/ActionBar.tsx": actionBarTemplate,
-            "components/layout/Button.tsx": buttonTemplate,
-            "components/layout/Callout.tsx": calloutTemplate,
-            "components/layout/Card.tsx": cardTemplate,
-            "components/layout/CherryThemeProvider.tsx": cherryThemeProviderTemplate,
-            "components/layout/ClientThemeProvider.tsx": clientThemeProviderTemplate,
-            "components/layout/Code.tsx": codeTemplate,
-            "components/layout/Columns.tsx": columnsTemplate,
-            "components/layout/DemoTheme.tsx": demoThemeTemplate,
-            "components/layout/DocsComponents.tsx": docsComponentsTemplate,
-            "components/layout/DocsNavigation.tsx": docsNavigationTemplate,
-            "components/layout/SectionBar.tsx": sectionBarTemplate,
-            "components/layout/Field.tsx": fieldTemplate,
-            "components/layout/Footer.tsx": footerTemplate,
-            "components/layout/GlobalStyles.ts": globalStylesTemplate,
-            "components/layout/Header.tsx": headerTemplate,
-            "components/layout/Icon.tsx": iconTemplate,
-            "components/layout/Pictograms.tsx": pictogramsTemplate,
-            "components/layout/SharedStyled.ts": sharedStyledTemplate,
-            "components/layout/StaticLinks.tsx": staticLinksTemplate,
-            "components/layout/Steps.tsx": stepsTemplate,
-            "components/layout/Tabs.tsx": tabsTemplate,
-            "components/layout/ThemeToggle.tsx": themeToggleTemplate,
-            "components/layout/Typography.ts": typographyTemplate,
-            "components/layout/Update.tsx": updateTemplate,
         };
         for (const [filePath, content] of Object.entries(structure)) {
             const fullPath = path.join(this.outputDir, filePath);
@@ -329,34 +77,7 @@ class MDXToNextJSGenerator {
         }
     }
     async createStartingDocs() {
-        const structure = {
-            "accordion.mdx": accordionMdxTemplate,
-            "ai-assistant.mdx": aiAssistantMdxTemplate,
-            "buttons.mdx": buttonsMdxTemplate,
-            "callouts.mdx": calloutsMdxTemplate,
-            "cards.mdx": cardsMdxTemplate,
-            "code.mdx": codeMdxTemplate,
-            "columns.mdx": columnsMdxTemplate,
-            "commands.mdx": commandsMdxTemplate,
-            "deployment.mdx": deploymentMdxTemplate,
-            "fields.mdx": fieldsMdxTemplate,
-            "fonts.mdx": fontsMdxTemplate,
-            "globals.mdx": globalsMdxTemplate,
-            "headers-and-text.mdx": headersAndTextMdxTemplate,
-            "icons.mdx": iconsMdxTemplate,
-            "image-and-embeds.mdx": imageAndEmbedsMdxTemplate,
-            "index.mdx": indexMdxTemplate,
-            "footer-links.mdx": footerLinksMdxTemplate,
-            "lists-and-tables.mdx": listAndTablesMdxTemplate,
-            "media-and-assets.mdx": mediaAndAssetsMdxTemplate,
-            "model-context-protocol.mdx": mcpMdxTemplate,
-            "navigation.mdx": navigationMdxTemplate,
-            "sections.mdx": sectionsMdxTemplate,
-            "steps.mdx": stepsMdxTemplate,
-            "tabs.mdx": tabsMdxTemplate,
-            "theme.mdx": themeMdxTemplate,
-            "update.mdx": updateMdxTemplate,
-        };
+        const structure = startingDocsStructure;
         const indexMdxExists = await fs.pathExists(path.join(this.watchDir, "index.mdx"));
         if (!indexMdxExists) {
             for (const [filePath, content] of Object.entries(structure)) {
@@ -898,22 +619,23 @@ export default function SectionIndex() {
         }
     }
     async generatePageFromMDX(mdxFile) {
+        const fm = mdxFile.frontmatter;
+        const metadataBlock = generateMetadataBlock({
+            title: fm.title,
+            titleFallback: "Generated with Doccupine",
+            name: fm.name,
+            titleOrder: "page-first",
+            description: fm.description,
+            icon: fm.icon,
+            image: fm.image,
+        });
         const pageContent = `import { Metadata } from "next";
 import { Docs } from "@/components/Docs";
 import { config } from "@/utils/config";
 
 const content = \`${escapeTemplateContent(mdxFile.content)}\`;
 
-export const metadata: Metadata = {
-  title: \`${mdxFile.frontmatter.title || "Generated with Doccupine"} \${config.name ? "- " + config.name : "- Doccupine"}\`,
-  description: \`${mdxFile.frontmatter.description ? mdxFile.frontmatter.description : '${config.description ? config.description : "Generated with Doccupine"}'}\`,
-  icons: \`${mdxFile.frontmatter.icon ? mdxFile.frontmatter.icon : '\${config.icon || "https://doccupine.com/favicon.ico"}'}\`,
-  openGraph: {
-    title: \`${mdxFile.frontmatter.title || "Generated with Doccupine"} \${config.name ? "- " + config.name : "- Doccupine"}\`,
-    description: \`${mdxFile.frontmatter.description ? mdxFile.frontmatter.description : '${config.description ? config.description : "Generated with Doccupine"}'}\`,
-    images: \`${mdxFile.frontmatter.image ? mdxFile.frontmatter.image : '\${config.preview || "https://doccupine.com/preview.png"}'}\`,
-  },
-};
+${metadataBlock}
 
 export default function Page() {
   return <Docs content={content} />;
@@ -937,37 +659,29 @@ export default function Page() {
                     description: frontmatter.description || "",
                     icon: frontmatter.icon,
                     image: frontmatter.image,
+                    name: frontmatter.name,
                 };
                 break;
             }
         }
+        const metadataBlock = indexMDX
+            ? generateMetadataBlock({
+                title: indexMDX.title,
+                titleFallback: "Welcome",
+                name: indexMDX.name,
+                titleOrder: "name-first",
+                description: indexMDX.description || undefined,
+                icon: indexMDX.icon,
+                image: indexMDX.image,
+            })
+            : generateRuntimeOnlyMetadataBlock();
         const indexContent = `import { Metadata } from "next";
 import { Docs } from "@/components/Docs";
 import { config } from "@/utils/config";
 
 ${indexMDX ? `const content = \`${escapeTemplateContent(indexMDX.content)}\`;` : `const content = null;`}
 
-${indexMDX
-            ? `export const metadata: Metadata = {
-  title: \`\${config.name ? config.name + " -" : "Doccupine -"} ${indexMDX.title}\`,
-  description: \`${indexMDX.description ? indexMDX.description : '${config.description ? config.description : "Generated with Doccupine"}'}\`,
-  icons: \`${indexMDX.icon ? indexMDX.icon : '\${config.icon || "https://doccupine.com/favicon.ico"}'}\`,
-  openGraph: {
-    title: \`\${config.name ? config.name + " -" : "Doccupine -"} ${indexMDX.title}\`,
-    description: \`${indexMDX.description ? indexMDX.description : '${config.description ? config.description : "Generated with Doccupine"}'}\`,
-    images: \`${indexMDX.image ? indexMDX.image : '\${config.preview || "https://doccupine.com/preview.png"}'}\`,
-  },
-};`
-            : `export const metadata: Metadata = {
-  title: \`\${config.name || "Doccupine"}\`,
-  description: \`\${config.description || "Generated with Doccupine"}\`,
-  icons: \`\${config.icon || "https://doccupine.com/favicon.ico"}\`,
-  openGraph: {
-    title: \`\${config.name || "Doccupine"}\`,
-    description: \`\${config.description || "Generated with Doccupine"}\`,
-    images: \`\${config.preview || "https://doccupine.com/preview.png"}\`,
-  },
-};`}
+${metadataBlock}
 
 export default function Home() {
   return <Docs content={content} />;
@@ -976,22 +690,22 @@ export default function Home() {
         await fs.writeFile(path.join(this.outputDir, "app", "page.tsx"), indexContent, "utf8");
     }
     async updateSectionIndex(sectionSlug, frontmatter, mdxContent) {
+        const metadataBlock = generateMetadataBlock({
+            title: frontmatter.title,
+            titleFallback: "Section",
+            name: frontmatter.name,
+            titleOrder: "name-first",
+            description: frontmatter.description || undefined,
+            icon: frontmatter.icon,
+            image: frontmatter.image,
+        });
         const indexContent = `import { Metadata } from "next";
 import { Docs } from "@/components/Docs";
 import { config } from "@/utils/config";
 
 const content = \`${escapeTemplateContent(mdxContent)}\`;
 
-export const metadata: Metadata = {
-  title: \`\${config.name ? config.name + " -" : "Doccupine -"} ${frontmatter.title || "Section"}\`,
-  description: \`${frontmatter.description ? frontmatter.description : '${config.description ? config.description : "Generated with Doccupine"}'}\`,
-  icons: \`${frontmatter.icon ? frontmatter.icon : '\${config.icon || "https://doccupine.com/favicon.ico"}'}\`,
-  openGraph: {
-    title: \`\${config.name ? config.name + " -" : "Doccupine -"} ${frontmatter.title || "Section"}\`,
-    description: \`${frontmatter.description ? frontmatter.description : '${config.description ? config.description : "Generated with Doccupine"}'}\`,
-    images: \`${frontmatter.image ? frontmatter.image : '\${config.preview || "https://doccupine.com/preview.png"}'}\`,
-  },
-};
+${metadataBlock}
 
 export default function Page() {
   return <Docs content={content} />;
@@ -1089,7 +803,10 @@ program
         if (output.includes("Ready") || output.includes("started")) {
             console.log(chalk.green(`🌐 Next.js ready at http://localhost:${port}`));
         }
-        if (output.includes("compiled") ||
+        if (options.verbose) {
+            process.stdout.write(chalk.gray("[Next.js] ") + output);
+        }
+        else if (output.includes("compiled") ||
             output.includes("error") ||
             output.includes("Ready")) {
             process.stdout.write(chalk.gray("[Next.js] ") + output);

package/dist/lib/config-manager.d.ts

@@ -0,0 +1,12 @@
+import type { DoccupineConfig } from "./types.js";
+export declare class ConfigManager {
+    private configPath;
+    constructor(configPath?: string);
+    loadConfig(): Promise<DoccupineConfig | null>;
+    saveConfig(config: DoccupineConfig): Promise<void>;
+    promptForConfig(existingConfig?: Partial<DoccupineConfig>): Promise<DoccupineConfig>;
+    getConfig(options?: {
+        reset?: boolean;
+        port?: string;
+    }): Promise<DoccupineConfig>;
+}

package/dist/lib/config-manager.js

@@ -0,0 +1,75 @@
+import fs from "fs-extra";
+import path from "path";
+import chalk from "chalk";
+import prompts from "prompts";
+export class ConfigManager {
+    configPath;
+    constructor(configPath = "doccupine.json") {
+        this.configPath = path.resolve(process.cwd(), configPath);
+    }
+    async loadConfig() {
+        try {
+            if (await fs.pathExists(this.configPath)) {
+                const configContent = await fs.readFile(this.configPath, "utf8");
+                const config = JSON.parse(configContent);
+                console.log(chalk.blue("📄 Using existing configuration from doccupine.json"));
+                return config;
+            }
+        }
+        catch (error) {
+            console.warn(chalk.yellow("⚠️ Error reading config file, will create new one"));
+        }
+        return null;
+    }
+    async saveConfig(config) {
+        try {
+            await fs.writeFile(this.configPath, JSON.stringify(config, null, 2), "utf8");
+            console.log(chalk.green("💾 Configuration saved to doccupine.json"));
+        }
+        catch (error) {
+            console.error(chalk.red("❌ Error saving config file:"), error);
+        }
+    }
+    async promptForConfig(existingConfig) {
+        const questions = [
+            {
+                type: "text",
+                name: "watchDir",
+                message: "Enter directory to watch for MDX files:",
+                initial: existingConfig?.watchDir || "docs",
+            },
+            {
+                type: "text",
+                name: "outputDir",
+                message: "Enter output directory for Next.js app:",
+                initial: existingConfig?.outputDir || "nextjs-app",
+            },
+        ];
+        const { watchDir, outputDir } = (await prompts(questions));
+        if (!watchDir || !outputDir) {
+            console.log(chalk.yellow("\n⚠️ Setup cancelled."));
+            process.exit(0);
+        }
+        return {
+            watchDir: path.resolve(process.cwd(), watchDir),
+            outputDir: path.resolve(process.cwd(), outputDir),
+            port: existingConfig?.port || "3000",
+        };
+    }
+    async getConfig(options = {}) {
+        let config = null;
+        if (!options.reset) {
+            config = await this.loadConfig();
+        }
+        if (!config || options.reset) {
+            console.log(chalk.blue("🔧 Setting up Doccupine configuration..."));
+            config = await this.promptForConfig(config || {});
+            await this.saveConfig(config);
+        }
+        if (options.port) {
+            config.port = options.port;
+            await this.saveConfig(config);
+        }
+        return config;
+    }
+}

package/dist/lib/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const DEFAULT_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.";
+export declare const DEFAULT_SITE_NAME = "Doccupine";
+export declare const DEFAULT_META_DESCRIPTION = "Generated with Doccupine";
+export declare const DEFAULT_FAVICON = "https://docs.doccupine.com/favicon.ico";
+export declare const DEFAULT_OG_IMAGE = "https://docs.doccupine.com/preview.png";

package/dist/lib/constants.js

@@ -0,0 +1,5 @@
+export const DEFAULT_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.";
+export const DEFAULT_SITE_NAME = "Doccupine";
+export const DEFAULT_META_DESCRIPTION = "Generated with Doccupine";
+export const DEFAULT_FAVICON = "https://docs.doccupine.com/favicon.ico";
+export const DEFAULT_OG_IMAGE = "https://docs.doccupine.com/preview.png";

package/dist/lib/layout.d.ts

@@ -0,0 +1,30 @@
+import type { SectionConfig } from "./types.js";
+interface PageData {
+    slug: string;
+    title: string;
+    description: string;
+    date: string | null;
+    category: string;
+    path: string;
+    categoryOrder: number;
+    order: number;
+    section: string;
+}
+interface GoogleFontConfig {
+    fontName?: string;
+    subsets?: string[];
+    weight?: string | string[];
+}
+interface LocalFontSrc {
+    path: string;
+    weight: string;
+    style: string;
+}
+interface FontConfig {
+    googleFont?: GoogleFontConfig;
+    localFonts?: string | {
+        src?: LocalFontSrc[];
+    };
+}
+export declare const layoutTemplate: (pages: PageData[], fontConfig: FontConfig | null, sectionsConfig?: SectionConfig[] | null) => string;
+export {};