@docubook/flame 1.5.4 → 1.6.1

package/.docu/node/deploy.ts

@@ -1,56 +1,111 @@
 /**
- * Deploy script - prepares .docu/dist for GitHub Pages
+ * Deploy script — 3 modes:
+ *   1. `flame deploy`           → build + generate GitHub Actions workflow
+ *   2. `flame deploy --docker`  → build + generate Docker deployment files
+ *   3. `flame deploy --docker --silent` → same as #2, minimal output
  *
- * Usage: bun deploy
- *   Runs build, adds .nojekyll, and generates GitHub Actions workflow.
+ * Bun-native path — uses Bun.write() and Bun.spawn().
  */
 
-import { writeFile, mkdir } from "node:fs/promises";
+import { mkdir } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { join } from "node:path";
 import { DIST_DIR, PROJECT_ROOT } from "./paths";
+import { HEADERS_FILE, NGINX_CONF, DOCKERIGNORE } from "./deploy.shared";
+
+export { HEADERS_FILE, NGINX_CONF, DOCKERIGNORE };
 
 const WORKFLOW_DIR = join(PROJECT_ROOT, ".github/workflows");
 const WORKFLOW_FILE = join(WORKFLOW_DIR, "deploy.yml");
 
-const HEADERS_FILE = `/assets/*
-  Cache-Control: public, max-age=31536000, immutable
-
-/assets/chunks/*
-  Cache-Control: public, max-age=31536000, immutable
-`;
+const isDocker = !!process.env.FLAME_DEPLOY_DOCKER;
+const isSilent = !!process.env.FLAME_DEPLOY_SILENT;
 
-async function deploy() {
-  console.log("📦 Building for production...\n");
+/** Logger that no-ops all non-error output in silent mode. */
+const log = isSilent
+  ? { info: () => {}, ok: () => {}, created: () => {}, out: () => {} }
+  : {
+      info: (m: string) => console.log(m),
+      ok: () => console.log("\n✅ Ready to deploy!"),
+      created: (m: string) => console.log(m),
+      out: (m: string) => console.log(m),
+    };
 
-  // Run build
+async function runBuild() {
   const build = Bun.spawn(["bun", "run", "build"], {
-    stdout: "inherit",
-    stderr: "inherit",
+    stdout: isSilent ? "ignore" : "inherit",
+    stderr: isSilent ? "ignore" : "inherit",
   });
   const exitCode = await build.exited;
   if (exitCode !== 0) {
     console.error("\n❌ Build failed");
     process.exit(1);
   }
+}
+
+export const DOCKERFILE_BUN = `FROM oven/bun:1 AS builder
+WORKDIR /app
+COPY package.json bun.lock ./
+RUN bun install --frozen-lockfile
+COPY . .
+RUN bun run build
+
+FROM nginx:alpine
+COPY --from=builder /app/.docu/dist /usr/share/nginx/html
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+USER nginx
+EXPOSE 80
+CMD ["nginx", "-g", "daemon off;"]
+`;
+
+async function writeDockerFiles() {
+  const dockerDir = PROJECT_ROOT;
 
-  // Add .nojekyll
-  await writeFile(join(DIST_DIR, ".nojekyll"), "");
+  if (!existsSync(join(dockerDir, "Dockerfile"))) {
+    await Bun.write(join(dockerDir, "Dockerfile"), DOCKERFILE_BUN);
+    log.created("📄 Created Dockerfile");
+  }
 
-  // _headers: long-cache immutable assets for Netlify/Cloudflare Pages.
-  // GitHub Pages ignores it (its CDN caches separately) — harmless to emit.
-  await writeFile(join(DIST_DIR, "_headers"), HEADERS_FILE);
+  if (!existsSync(join(dockerDir, "nginx.conf"))) {
+    await Bun.write(join(dockerDir, "nginx.conf"), NGINX_CONF);
+    log.created("📄 Created nginx.conf");
+  }
 
-  // Generate GitHub Actions workflow
+  if (!existsSync(join(dockerDir, ".dockerignore"))) {
+    await Bun.write(join(dockerDir, ".dockerignore"), DOCKERIGNORE);
+    log.created("📄 Created .dockerignore");
+  }
+}
+
+async function writeGhaWorkflow() {
   if (!existsSync(WORKFLOW_FILE)) {
     await mkdir(WORKFLOW_DIR, { recursive: true });
-    await writeFile(WORKFLOW_FILE, GITHUB_ACTIONS_WORKFLOW);
-    console.log("\n📄 Created .github/workflows/deploy.yml");
+    await Bun.write(WORKFLOW_FILE, GITHUB_ACTIONS_WORKFLOW);
+    log.created("📄 Created .github/workflows/deploy.yml");
   }
+}
+
+async function deploy() {
+  log.info("📦 Building for production...\n");
+  await runBuild();
+
+  // Common: .nojekyll + _headers
+  await Bun.write(join(DIST_DIR, ".nojekyll"), "");
+  await Bun.write(join(DIST_DIR, "_headers"), HEADERS_FILE);
 
-  console.log("\n✅ Ready to deploy!");
-  console.log("   Output: .docu/dist/");
-  console.log("   Push to GitHub and enable Pages (Settings → Pages → Source: GitHub Actions)");
+  if (isDocker) {
+    await writeDockerFiles();
+  } else {
+    await writeGhaWorkflow();
+  }
+
+  log.ok();
+  log.out("   Output: .docu/dist/");
+  if (isDocker) {
+    log.out("   Run: docker build -t my-docs . && docker run -p 80:80 my-docs");
+  } else {
+    log.out("   Push to GitHub and enable Pages (Settings → Pages → Source: GitHub Actions)");
+  }
 }
 
 const GITHUB_ACTIONS_WORKFLOW = `name: Deploy to GitHub Pages
@@ -73,7 +128,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
         with:
           fetch-depth: 0
 
@@ -103,7 +158,9 @@ jobs:
         uses: actions/deploy-pages@v4
 `;
 
-deploy().catch((err) => {
-  console.error("Deploy failed:", err);
-  process.exit(1);
-});
+if (import.meta.main) {
+  deploy().catch((err) => {
+    console.error("Deploy failed:", err);
+    process.exit(1);
+  });
+}

package/.docu/node/html.shared.ts

@@ -79,6 +79,7 @@ export function htmlShell(opts: HtmlShellOptions): string {
   <title>${escapeHtml(title)}</title>
   <meta name="description" content="${escapeHtml(description)}">
   ${favicon ? `<link rel="icon" type="image/x-icon" href="${escapeHtml(resolvePath(favicon))}">` : ""}${themeStyle}
+  <link rel="preload" href="${escapeHtml(assetPrefix + css)}" as="style">
   <link rel="stylesheet" href="${escapeHtml(assetPrefix + css)}">
   ${csp ? `<meta http-equiv="Content-Security-Policy" content="${escapeHtml(csp)}">` : ""}
   ${seoTags}
@@ -86,6 +87,7 @@ export function htmlShell(opts: HtmlShellOptions): string {
 </head>
 <body>
   <div id="root">${body}</div>
+  <link rel="modulepreload" href="${escapeHtml(assetPrefix + js)}">
   <script type="module"${nonceAttr} src="${escapeHtml(assetPrefix + js)}"></script>${extraScripts ? `\n  ${extraScripts}` : ""}${bodyInjection}
 </body>
 </html>`;

package/.docu/node/html.ts

@@ -1,30 +1,5 @@
-import type { SeoMeta } from "./seo";
-
-export interface HtmlShellOptions {
-  title: string;
-  description: string;
-  body: string;
-  favicon: string;
-  css: string;
-  js: string;
-  nonce?: string;
-  /**
-   * Content-Security-Policy value (from `cspHeader()` in security.ts).
-   * When provided, injects `<meta http-equiv="Content-Security-Policy">` in `<head>`.
-   * Essential for static deployment where HTTP headers cannot be set.
-   */
-  csp?: string;
-  extraScripts?: string;
-  themeCss?: string;
-  /** Depth from document root (0=root, 1=subdir, 2=sub/subdir). Used for relative asset paths. */
-  depth?: number;
-  /** HTML strings to inject before `</head>` (from plugin `injectHead` hooks). */
-  headExtra?: string[];
-  /** HTML strings to inject before `</body>`, after the main script (from plugin `injectBody` hooks). */
-  bodyExtra?: string[];
-  /** SEO meta tags derived from config + frontmatter */
-  seo?: SeoMeta;
-}
+import type { HtmlShellOptions } from "./html.shared";
+export type { HtmlShellOptions };
 
 export function htmlShell(opts: HtmlShellOptions): string {
   const {
@@ -69,6 +44,7 @@ export function htmlShell(opts: HtmlShellOptions): string {
   <title>${Bun.escapeHTML(title)}</title>
   <meta name="description" content="${Bun.escapeHTML(description)}">
   ${favicon ? `<link rel="icon" type="image/x-icon" href="${Bun.escapeHTML(resolvePath(favicon))}">` : ""}${themeStyle}
+  <link rel="preload" href="${Bun.escapeHTML(assetPrefix + css)}" as="style">
   <link rel="stylesheet" href="${Bun.escapeHTML(assetPrefix + css)}">
   ${csp ? `<meta http-equiv="Content-Security-Policy" content="${Bun.escapeHTML(csp)}">` : ""}
   ${seoTags}
@@ -76,6 +52,7 @@ export function htmlShell(opts: HtmlShellOptions): string {
 </head>
 <body>
   <div id="root">${body}</div>
+  <link rel="modulepreload" href="${Bun.escapeHTML(assetPrefix + js)}">
   <script type="module"${nonceAttr} src="${Bun.escapeHTML(assetPrefix + js)}"></script>${extraScripts ? `\n  ${extraScripts}` : ""}${bodyInjection}
 </body>
 </html>`;

package/.docu/node/hydrate.node.ts

@@ -58,10 +58,42 @@ function resolveTailwindBin(): string {
   return join(dirname(pkgPath), binRel);
 }
 
-/** Run Tailwind CLI to produce minified CSS. */
-async function runTailwind(outputCss: string): Promise<void> {
+/** Compute a cache key from globals.css + theme config content. */
+function tailwindCacheKey(): string {
+  const globalsPath = join(STYLES_DIR, "globals.css");
+  const globalsContent = existsSync(globalsPath) ? readFileSync(globalsPath, "utf-8") : "";
+  let themeSuffix = "";
+  try {
+    const themeColors = getThemeConfig();
+    if (themeColors) {
+      themeSuffix = JSON.stringify(themeColors);
+    }
+  } catch {
+    // theme config unavailable — proceed without it
+  }
+  return createHash("md5")
+    .update(globalsContent + themeSuffix)
+    .digest("hex")
+    .slice(0, 16);
+}
+
+/**
+ * Build Tailwind CSS with content-based caching.
+ * If a CSS file for the current input hash already exists, skip the subprocess.
+ * Returns the filename (e.g. "client-abc123.css") and CSS content.
+ */
+async function buildTailwindCss(key: string): Promise<{ file: string; content: string }> {
+  const cachedFile = `client-${key}.css`;
+  const cachedPath = join(ASSETS_DIR, cachedFile);
+
+  if (existsSync(cachedPath)) {
+    const content = readFileSync(cachedPath, "utf-8");
+    return { file: cachedFile, content };
+  }
+
+  const tmpCss = join(ASSETS_DIR, `_tmp-${key}.css`);
   const bin = resolveTailwindBin();
-  const twArgs = ["-i", join(STYLES_DIR, "globals.css"), "-o", outputCss, "--minify"];
+  const twArgs = ["-i", join(STYLES_DIR, "globals.css"), "-o", tmpCss, "--minify"];
   const isDeno = "Deno" in globalThis;
   const args = isDeno ? ["run", "-A", bin, ...twArgs] : [bin, ...twArgs];
   try {
@@ -70,6 +102,31 @@ async function runTailwind(outputCss: string): Promise<void> {
     const stderr = (err as { stderr?: string }).stderr ?? String(err);
     throw new Error(`Tailwind CSS build failed:\n${stderr}`, { cause: err });
   }
+
+  let cssContent = await readFile(tmpCss, "utf-8");
+  await unlink(tmpCss);
+
+  try {
+    const themeColors = getThemeConfig();
+    if (themeColors) {
+      cssContent = buildThemeCss(cssContent, themeColors);
+    }
+  } catch (err) {
+    console.warn(
+      `[flame] Failed to resolve theme config, falling back to globals.css only: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+
+  // Use the same input-derived key for lookup and output — if inputs change,
+  // the key changes, cache busting works without a separate content hash.
+  const cssFile = `client-${key}.css`;
+  const outPath = join(ASSETS_DIR, cssFile);
+
+  if (!existsSync(outPath)) {
+    await writeFile(outPath, cssContent);
+  }
+
+  return { file: cssFile, content: cssContent };
 }
 
 const NODE_BUILTINS_RE = new RegExp(
@@ -111,8 +168,10 @@ function scanDirLucideIcons(dir: string, set: Set<string>): void {
         }
       }
     }
-  } catch {
-    /* skip unreadable dirs */
+  } catch (err) {
+    console.warn(
+      `[flame] Failed to scan lucide icons: ${err instanceof Error ? err.message : String(err)}`
+    );
   }
 }
 
@@ -138,7 +197,8 @@ function collectAllLucideIcons(): string[] {
 /** Build the client JS bundle and Tailwind CSS. */
 export async function buildClientBundle(): Promise<{ js: string; css: string }> {
   await mkdir(ASSETS_DIR, { recursive: true });
-  await cleanOldBundles();
+  const twKey = tailwindCacheKey();
+  await cleanOldBundles(new Set([`client-${twKey}.css`]));
 
   const nodeEnv = process.env.NODE_ENV || "development";
   const esbuild = await import("esbuild");
@@ -153,10 +213,8 @@ export async function buildClientBundle(): Promise<{ js: string; css: string }>
       bundle: true,
       outdir: ASSETS_DIR,
       entryNames: "client-[hash]",
-      chunkNames: "chunks/[name]-[hash]",
       platform: "browser",
       format: "esm",
-      splitting: true,
       minify: nodeEnv === "production",
       define: { "process.env.NODE_ENV": JSON.stringify(nodeEnv) },
       jsx: "automatic",
@@ -185,17 +243,17 @@ export async function buildClientBundle(): Promise<{ js: string; css: string }>
               if (args.namespace === "lucide-virt") {
                 return { path: getLucideRealEntry(), namespace: "file" };
               }
-              // Files that do dynamic name lookups (namespace import)
-              // need the full barrel — bypass the virtual module.
+              // mdx-content Icon.tsx uses namespace import for arbitrary
+              // user-provided icon names in MDX — keep full barrel there.
               if (args.importer) {
                 const normalized = normalizeImporterPath(args.importer);
-                if (
-                  normalized.endsWith("/.docu/components/Lucide.tsx") ||
-                  normalized.includes("/mdx-content/dist/")
-                ) {
+                if (normalized.includes("/mdx-content/dist/")) {
                   return { path: getLucideRealEntry(), namespace: "file" };
                 }
               }
+              // All other files get tree-shaken via the virtual module.
+              // Lucide.tsx renders only config-defined icons, which are
+              // collected by extractConfigIcons() + collectAllLucideIcons().
               return { path: args.path, namespace: "lucide-virt" };
             });
             build.onLoad({ filter: /.*/, namespace: "lucide-virt" }, () => {
@@ -226,7 +284,6 @@ export async function buildClientBundle(): Promise<{ js: string; css: string }>
             });
           },
         },
-
       ],
     });
   } finally {
@@ -235,10 +292,7 @@ export async function buildClientBundle(): Promise<{ js: string; css: string }>
     await esbuild.stop();
   }
 
-  // With splitting enabled esbuild emits the entry plus shared/dynamic chunks.
-  // `entryPoint` is set on the user entry AND on every dynamic-import chunk
-  // (esbuild treats dynamic imports as entry points), so match the resolved
-  // source path instead of grabbing the first truthy `entryPoint`.
+  // The single entry produces one output. Match resolved source path.
   const { outputs } = result.metafile!;
   const jsOutput = Object.keys(outputs).find((p) => {
     const o = outputs[p];
@@ -249,26 +303,7 @@ export async function buildClientBundle(): Promise<{ js: string; css: string }>
   }
   const jsFile = basename(jsOutput);
 
-  const tmpCss = join(ASSETS_DIR, "_tmp.css");
-  await runTailwind(tmpCss);
-
-  let cssContent = await readFile(tmpCss, "utf-8");
-
-  try {
-    const themeColors = getThemeConfig();
-    if (themeColors) {
-      cssContent = buildThemeCss(cssContent, themeColors);
-    }
-  } catch (err) {
-    console.warn(
-      `[flame] Failed to resolve theme config, falling back to globals.css only: ${err instanceof Error ? err.message : String(err)}`
-    );
-  }
-
-  const cssHash = createHash("md5").update(cssContent).digest("hex").slice(0, 8);
-  const cssFile = `client-${cssHash}.css`;
-  await writeFile(join(ASSETS_DIR, cssFile), cssContent);
-  await unlink(tmpCss);
+  const { file: cssFile } = await buildTailwindCss(twKey);
 
   await writeFile(join(ASSETS_DIR, "manifest.json"), JSON.stringify({ js: jsFile, css: cssFile }));
 

package/.docu/node/hydrate.ts

@@ -1,5 +1,7 @@
 import { join } from "node:path";
 import { mkdir, unlink } from "node:fs/promises";
+import { existsSync, readFileSync } from "node:fs";
+import { createHash } from "node:crypto";
 import { resolveTheme, generateThemeCss, presetRegistry } from "@docubook/themes-colors";
 import { ASSETS_DIR, cleanOldBundles, LIB_DIR, STYLES_DIR, loadDocuConfig } from "./paths";
 import { resolveRoutes } from "./fs-scanner";
@@ -55,24 +57,86 @@ export function computeInlineThemeCss(): string | undefined {
   return undefined;
 }
 
+/** Compute Tailwind cache key from globals.css + theme config. */
+function twCacheKey(): string {
+  const globalsPath = join(STYLES_DIR, "globals.css");
+  const globals = existsSync(globalsPath) ? readFileSync(globalsPath, "utf-8") : "";
+  let themeSuffix = "";
+  try {
+    const themeColors = getThemeConfig();
+    if (themeColors) themeSuffix = JSON.stringify(themeColors);
+  } catch {
+    // theme config unavailable — proceed without
+  }
+  return createHash("md5")
+    .update(globals + themeSuffix)
+    .digest("hex")
+    .slice(0, 16);
+}
+
+/** Run Tailwind CLI, caching by content hash. */
+async function buildTailwindCss(key: string): Promise<{ file: string; content: string }> {
+  const cachedFile = `client-${key}.css`;
+  const cachedPath = join(ASSETS_DIR, cachedFile);
+
+  if (existsSync(cachedPath)) {
+    const content = await Bun.file(cachedPath).text();
+    return { file: cachedFile, content };
+  }
+
+  const tmpCss = join(ASSETS_DIR, `_tmp-${key}.css`);
+  const proc = Bun.spawn(
+    [
+      "bun",
+      "x",
+      "@tailwindcss/cli",
+      "-i",
+      join(STYLES_DIR, "globals.css"),
+      "-o",
+      tmpCss,
+      "--minify",
+    ],
+    { stdout: "ignore", stderr: "pipe" }
+  );
+  await proc.exited;
+  if (proc.exitCode !== 0) {
+    const err = await new Response(proc.stderr).text();
+    throw new Error(`Tailwind CSS build failed:\n${err}`);
+  }
+
+  let cssContent = await Bun.file(tmpCss).text();
+  await unlink(tmpCss);
+
+  try {
+    const themeColors = getThemeConfig();
+    if (themeColors) cssContent = buildThemeCss(cssContent, themeColors);
+  } catch (err) {
+    console.warn(
+      `[flame] Failed to resolve theme config: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+
+  // Use the same input-derived key for lookup and output — if inputs change,
+  // the key changes, cache busting works without a separate content hash.
+  const cssFile = `client-${key}.css`;
+  const outPath = join(ASSETS_DIR, cssFile);
+  if (!existsSync(outPath)) await Bun.write(outPath, cssContent);
+
+  return { file: cssFile, content: cssContent };
+}
+
 export async function buildClientBundle(): Promise<{ js: string; css: string }> {
   await mkdir(ASSETS_DIR, { recursive: true });
-  await cleanOldBundles();
+  const twKey = twCacheKey();
+  await cleanOldBundles(new Set([`client-${twKey}.css`]));
 
   const nodeEnv = process.env.NODE_ENV || "development";
   const result = await Bun.build({
     entrypoints: [join(LIB_DIR, "client.ts")],
     outdir: ASSETS_DIR,
-    format: "esm",
-    splitting: true,
-    naming: {
-      entry: "client-[hash].[ext]",
-      chunk: "chunks/[name]-[hash].[ext]",
-      asset: "[name]-[hash].[ext]",
-    },
+    naming: "client-[hash].[ext]",
     target: "browser",
     minify: nodeEnv === "production",
-    optimizeImports: ["lucide-react"],
     define: { "process.env.NODE_ENV": JSON.stringify(nodeEnv) },
     plugins: [
       {
@@ -92,7 +156,6 @@ export async function buildClientBundle(): Promise<{ js: string; css: string }>
           });
         },
       },
-
     ],
   });
 
@@ -104,50 +167,13 @@ export async function buildClientBundle(): Promise<{ js: string; css: string }>
   if (!result.outputs[0]) {
     throw new Error("Client bundle produced no output files");
   }
-  // With splitting enabled Bun emits entry + chunk artifacts; select the entry
-  // explicitly rather than by position (chunks may precede it in the array).
   const entry = result.outputs.find((o) => o.kind === "entry-point");
   if (!entry) {
     throw new Error("Client bundle produced no entry-point output");
   }
   const jsFile = entry.path.split("/").pop()!;
-  const tmpCss = join(ASSETS_DIR, "_tmp.css");
-  const proc = Bun.spawn(
-    [
-      "bun",
-      "x",
-      "@tailwindcss/cli",
-      "-i",
-      join(STYLES_DIR, "globals.css"),
-      "-o",
-      tmpCss,
-      "--minify",
-    ],
-    { stdout: "ignore", stderr: "pipe" }
-  );
-  await proc.exited;
-  if (proc.exitCode !== 0) {
-    const err = await new Response(proc.stderr).text();
-    throw new Error(`Tailwind CSS build failed:\n${err}`);
-  }
 
-  let cssContent = await Bun.file(tmpCss).text();
-
-  try {
-    const themeColors = getThemeConfig();
-    if (themeColors) {
-      cssContent = buildThemeCss(cssContent, themeColors);
-    }
-  } catch (err) {
-    console.warn(
-      `[flame] Failed to resolve theme config, falling back to globals.css only: ${err instanceof Error ? err.message : String(err)}`
-    );
-  }
-
-  const cssHash = new Bun.CryptoHasher("md5").update(cssContent).digest("hex").slice(0, 8);
-  const cssFile = `client-${cssHash}.css`;
-  await Bun.write(join(ASSETS_DIR, cssFile), cssContent);
-  await unlink(tmpCss);
+  const { file: cssFile } = await buildTailwindCss(twKey);
 
   await Bun.write(join(ASSETS_DIR, "manifest.json"), JSON.stringify({ js: jsFile, css: cssFile }));
 

package/.docu/node/paths.ts

@@ -32,11 +32,12 @@ export const DOCU_CONFIG_PATH = join(PROJECT_ROOT, "docu.json");
 // Config singleton
 let _config: DocuConfig | null = null;
 
-/** Clean stale client bundles and split chunks from a previous build. */
-export async function cleanOldBundles() {
+/** Clean stale client bundles from a previous build. */
+export async function cleanOldBundles(preserve?: Set<string>) {
   try {
     const files = await readdir(ASSETS_DIR);
     for (const file of files) {
+      if (preserve?.has(file)) continue;
       if (file.startsWith("client.") || file.startsWith("client-")) {
         await unlink(join(ASSETS_DIR, file));
       }
@@ -46,12 +47,13 @@ export async function cleanOldBundles() {
       console.error("Failed to clean old bundles:", (err as Error).message);
     }
   }
-  // Stale split chunks accumulate across builds (content-hashed names); drop
-  // the whole chunks dir so only the new build's chunks remain.
   try {
     await rm(join(ASSETS_DIR, "chunks"), { recursive: true, force: true });
   } catch (err) {
-    console.error("Failed to clean old chunks:", (err as Error).message);
+    // chunks dir may not exist, or permission error — log to avoid silent failure
+    if ((err as NodeJS.ErrnoException).code !== "ENOENT") {
+      console.warn("[flame] Failed to clean chunks dir:", (err as Error).message);
+    }
   }
 }
 

package/.docu/node/server-routes.ts

@@ -279,7 +279,8 @@ export function serveStatic(pathname: string): Response | null {
 
 export function serverErrorResponse(error: unknown): Response {
   const msg = error instanceof Error ? error.message : "Unknown error";
-  const st = error instanceof Error ? error.stack : undefined;
+  const st =
+    process.env.NODE_ENV !== "production" && error instanceof Error ? error.stack : undefined;
   return new Response(errorHtml(msg, st), {
     status: 500,
     headers: {

package/bin/cli.js

@@ -12,10 +12,13 @@ const __dirname = import.meta.dirname;
 // Deno's npm compat layer may expose `Bun` via globals, check execPath first.
 const runtime =
   process.env.FLAME_RUNTIME ||
-  (process.execPath.includes("deno") ? "deno" :
-   typeof Bun !== "undefined" ? "bun" :
-   typeof Deno !== "undefined" ? "deno" :
-   "node");
+  (process.execPath.includes("deno")
+    ? "deno"
+    : typeof Bun !== "undefined"
+      ? "bun"
+      : typeof Deno !== "undefined"
+        ? "deno"
+        : "node");
 
 const COMMAND_MAP = {
   bun: {
@@ -48,11 +51,15 @@ if (!COMMAND_MAP) {
 
 const command = process.argv[2];
 
-// Parse --theme flag: set env before importing build script
+// Parse flags
 const themeIndex = process.argv.indexOf("--theme");
 if (themeIndex !== -1 && themeIndex + 1 < process.argv.length) {
   process.env.FLAME_THEME = process.argv[themeIndex + 1];
 }
+const hasDocker = process.argv.includes("--docker");
+const hasSilent = process.argv.includes("--silent");
+if (hasDocker) process.env.FLAME_DEPLOY_DOCKER = "1";
+if (hasSilent) process.env.FLAME_DEPLOY_SILENT = "1";
 
 if (!command || command === "--help" || command === "-h") {
   console.log(`
@@ -71,6 +78,8 @@ if (!command || command === "--help" || command === "-h") {
   Options:
     --help        Show this help message
     --theme <name>  Override theme preset (e.g. freshlime, coffee). Works with dev, build, preview.
+    --docker      Generate Docker deployment files (Dockerfile + nginx.conf). Works with deploy.
+    --silent      Suppress non-essential output. Works with deploy.
 `);
   process.exit(0);
 }
@@ -120,11 +129,15 @@ if (command === "init") {
     }
     writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
 
+    // Runtime detection via shebang (#!/usr/bin/env node) makes typeof Bun
+    // unavailable — check for bun.lock as a reliable Bun indicator.
+    const isBun = existsSync(join(targetDir, "bun.lock"));
+    const pkgManager = runtime === "deno" ? "deno" : isBun ? "bun" : "node";
     const nextSteps = {
       bun: "    bun install\n    bun run dev",
       node: "    npm install\n    npm run dev",
       deno: "    deno task dev\n\n  ⚠️  If you see a freshness error, run:\n    DENO_ALLOW_NEWER=true deno task dev",
-    }[runtime];
+    }[pkgManager];
     console.log(`\n  ✓ Project scaffolded!\n\n  Next steps:\n${nextSteps}\n`);
     process.exit(0);
   } catch (err) {