@docubook/flame 1.6.5 → 1.7.0

package/.docu/lib/build.deno.js

@@ -1,9 +1,9 @@
 import {
   runBuildCli
-} from "./chunk-OUILOW2S.js";
-import "./chunk-WSJC3PRH.js";
+} from "./chunk-7GWATWNE.js";
+import "./chunk-VW7B64WE.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-I7OBFORY.js";
+import "./chunk-PL3JZCCY.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/build.deno.ts

package/.docu/lib/{build.impl-VCWNBEBU.js → build.impl-F4M6HJXA.js}

@@ -1,10 +1,10 @@
 import {
   runBuild,
   runBuildCli
-} from "./chunk-OUILOW2S.js";
-import "./chunk-WSJC3PRH.js";
+} from "./chunk-7GWATWNE.js";
+import "./chunk-VW7B64WE.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-I7OBFORY.js";
+import "./chunk-PL3JZCCY.js";
 import "./chunk-4IQXHHPF.js";
 export {
   runBuild,

package/.docu/lib/build.node.js

@@ -1,9 +1,9 @@
 import {
   runBuildCli
-} from "./chunk-OUILOW2S.js";
-import "./chunk-WSJC3PRH.js";
+} from "./chunk-7GWATWNE.js";
+import "./chunk-VW7B64WE.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-I7OBFORY.js";
+import "./chunk-PL3JZCCY.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/build.node.ts

package/.docu/lib/{chunk-P2P2NB3K.js → chunk-4NI6P6NM.js}

@@ -1,12 +1,16 @@
 import {
   DIST_DIR,
+  FRAMEWORK_ROOT,
   PROJECT_ROOT
 } from "./chunk-4IQXHHPF.js";
 
 // .docu/node/deploy.shared.ts
 import { writeFile, mkdir } from "node:fs/promises";
-import { existsSync } from "node:fs";
-import { join } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+var FLAME_MAJOR = JSON.parse(
+  readFileSync(resolve(FRAMEWORK_ROOT, "package.json"), "utf-8")
+).version.split(".")[0];
 var WORKFLOW_DIR = join(PROJECT_ROOT, ".github/workflows");
 var WORKFLOW_FILE = join(WORKFLOW_DIR, "deploy.yml");
 var NGINX_CONF = `server {
@@ -54,7 +58,6 @@ var NGINX_CONF = `server {
 }
 `;
 var DOCKERIGNORE = `node_modules
-.git
 *.DS_Store
 .docu/dist
 .docu/lib
@@ -117,6 +120,7 @@ var HEADERS_FILE = `/*
 `;
 var isDocker = !!process.env.FLAME_DEPLOY_DOCKER;
 var isSilent = !!process.env.FLAME_DEPLOY_SILENT;
+var isCi = !!process.env.FLAME_DEPLOY_CI;
 var log = isSilent ? { info: () => {
 }, ok: () => {
 }, created: () => {
@@ -133,22 +137,19 @@ async function runBuild() {
     process.env.FLAME_BUILD_SILENT = "1";
     process.env.LOG_LEVEL = "error";
   }
-  const { runBuildCli } = await import("./build.impl-VCWNBEBU.js");
+  const { runBuildCli } = await import("./build.impl-F4M6HJXA.js");
   await runBuildCli();
 }
 async function writeDockerFiles() {
   const dockerDir = PROJECT_ROOT;
-  const pm = detectPkgManager(dockerDir);
   if (!existsSync(join(dockerDir, "Dockerfile"))) {
     await writeFile(
       join(dockerDir, "Dockerfile"),
-      `FROM ${pm.baseImage} AS builder
+      `FROM ghcr.io/docubook/flame-builder:${FLAME_MAJOR} AS builder
 ENV NODE_ENV=production
 WORKDIR /app
-COPY package.json ${pm.lockFile} ./
-RUN ${pm.installCmd}
 COPY . .
-RUN ${pm.runCmd} run build
+RUN flame build
 
 FROM nginx:alpine
 COPY --from=builder /app/.docu/dist /usr/share/nginx/html
@@ -246,6 +247,43 @@ function generateWorkflowYml() {
     "        uses: actions/deploy-pages@v4"
   ].join("\n");
 }
+function generateDockerWorkflowYml() {
+  const imageName = "ghcr.io/${{ github.repository }}";
+  return [
+    `name: Build & Push Docker Image`,
+    "",
+    "on:",
+    "  push:",
+    "    branches: [main]",
+    "  workflow_dispatch:",
+    "",
+    "permissions:",
+    "  contents: read",
+    "  packages: write",
+    "",
+    "jobs:",
+    "  build:",
+    "    runs-on: ubuntu-latest",
+    "    steps:",
+    "      - uses: actions/checkout@v4",
+    "        with:",
+    "          fetch-depth: 0",
+    "",
+    "      - name: Log in to GHCR",
+    "        uses: docker/login-action@v3",
+    "        with:",
+    "          registry: ghcr.io",
+    "          username: ${{ github.actor }}",
+    "          password: ${{ secrets.GITHUB_TOKEN }}",
+    "",
+    "      - name: Build & push",
+    "        uses: docker/build-push-action@v5",
+    "        with:",
+    "          context: .",
+    `          tags: ${imageName}:latest`,
+    "          push: true"
+  ].join("\n");
+}
 async function writeGhaWorkflow() {
   if (!existsSync(WORKFLOW_FILE)) {
     await mkdir(WORKFLOW_DIR, { recursive: true });
@@ -253,6 +291,14 @@ async function writeGhaWorkflow() {
     log.created("\u{1F4C4} Created .github/workflows/deploy.yml");
   }
 }
+var DOCKER_WORKFLOW_FILE = join(WORKFLOW_DIR, "deploy-docker.yml");
+async function writeDockerWorkflow() {
+  if (!existsSync(DOCKER_WORKFLOW_FILE)) {
+    await mkdir(WORKFLOW_DIR, { recursive: true });
+    await writeFile(DOCKER_WORKFLOW_FILE, generateDockerWorkflowYml());
+    log.created("\u{1F4C4} Created .github/workflows/deploy-docker.yml");
+  }
+}
 async function runDeploy() {
   log.info("\u{1F4E6} Building for production...\n");
   await runBuild();
@@ -260,13 +306,20 @@ async function runDeploy() {
   await writeFile(join(DIST_DIR, "_headers"), HEADERS_FILE);
   if (isDocker) {
     await writeDockerFiles();
+    if (isCi) await writeDockerWorkflow();
   } 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");
+    log.out("   Build locally: docker build -t my-docs . && docker run -p 80:80 my-docs");
+    if (isCi) {
+      log.out("   Push to GitHub \u2014 CI will build & push Docker image to GHCR");
+      log.out("   Then pull latest image on your hosting platform (Coolify, etc.)");
+    } else {
+      log.out("   For Coolify: connect repo, set build pack to Dockerfile");
+    }
   } else {
     log.out("   Push to GitHub and enable Pages (Settings \u2192 Pages \u2192 Source: GitHub Actions)");
   }

package/.docu/lib/{chunk-OUILOW2S.js → chunk-7GWATWNE.js}

@@ -13,7 +13,7 @@ import {
   htmlShell,
   initSentry,
   loadPlugins
-} from "./chunk-WSJC3PRH.js";
+} from "./chunk-VW7B64WE.js";
 import {
   cspHeader,
   generateNonce,
@@ -21,7 +21,7 @@ import {
 } from "./chunk-EOK6KATZ.js";
 import {
   logger
-} from "./chunk-I7OBFORY.js";
+} from "./chunk-PL3JZCCY.js";
 import {
   ASSETS_DIR,
   CACHE_FILE,

package/.docu/lib/{chunk-I7OBFORY.js → chunk-PL3JZCCY.js}

@@ -5,7 +5,7 @@ import {
 // package.json
 var package_default = {
   name: "@docubook/flame",
-  version: "1.6.5",
+  version: "1.7.0",
   description: "A blazing-fast React + MDX framework powered by Bun, built for modern documentation experiences.",
   type: "module",
   bin: {

package/.docu/lib/{chunk-Y4PEPREZ.js → chunk-UDDWU5NP.js}

@@ -14,7 +14,7 @@ import {
   htmlShell,
   initSentry,
   loadPlugins
-} from "./chunk-WSJC3PRH.js";
+} from "./chunk-VW7B64WE.js";
 import {
   SECURITY_HEADERS,
   generateNonce,
@@ -27,7 +27,7 @@ import {
 } from "./chunk-EOK6KATZ.js";
 import {
   logger
-} from "./chunk-I7OBFORY.js";
+} from "./chunk-PL3JZCCY.js";
 import {
   DIST_DIR,
   DOCS_DIR,

package/.docu/lib/{chunk-74AOEDLW.js → chunk-VJKIFRLV.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-EOK6KATZ.js";
 import {
   logger
-} from "./chunk-I7OBFORY.js";
+} from "./chunk-PL3JZCCY.js";
 import {
   DIST_DIR
 } from "./chunk-4IQXHHPF.js";

package/.docu/lib/{chunk-WSJC3PRH.js → chunk-VW7B64WE.js}

@@ -555,8 +555,8 @@ function scanDir(dirPath, docsRoot) {
     if (entry.startsWith(".") || entry === "assets") continue;
     const absPath = join(dirPath, entry);
     try {
-      const stat = statSync(absPath);
-      if (stat.isDirectory()) {
+      const stat2 = statSync(absPath);
+      if (stat2.isDirectory()) {
         const children = scanDir(absPath, docsRoot);
         if (children.length > 0) {
           nodes.push({
@@ -567,7 +567,7 @@ function scanDir(dirPath, docsRoot) {
             children
           });
         }
-      } else if (stat.isFile() && isDocFile(entry)) {
+      } else if (stat2.isFile() && isDocFile(entry)) {
         nodes.push({
           name: entry,
           relPath: normalizePath(relative(docsRoot, absPath).replace(/\.(mdx|md)$/, "")),
@@ -1073,6 +1073,7 @@ function captureException(err, context) {
 
 // .docu/node/git.ts
 import { execFile as execFile2 } from "node:child_process";
+import { stat } from "node:fs/promises";
 function runGit(args) {
   return new Promise((resolve4, reject) => {
     execFile2("git", args, { maxBuffer: 16 * 1024 * 1024 }, (err, stdout) => {
@@ -1098,6 +1099,14 @@ async function getGitLastModified(filePath) {
     return null;
   }
 }
+async function getFilesystemMtime(filePath) {
+  try {
+    const stats = await stat(filePath);
+    return stats.mtime.toISOString();
+  } catch {
+    return null;
+  }
+}
 async function getGitLastModifiedBatch(filePaths) {
   const result = /* @__PURE__ */ new Map();
   if (filePaths.length === 0) return result;
@@ -1208,7 +1217,7 @@ async function compileMdx(rawMdx, filePath, gitDates, remarkPlugins, rehypePlugi
     frontmatter: {},
     components
   });
-  const date = frontmatter.date || gitDates?.get(filePath) || await getGitLastModified(filePath) || void 0;
+  const date = frontmatter.date || gitDates?.get(filePath) || await getGitLastModified(filePath) || await getFilesystemMtime(filePath) || void 0;
   return {
     content,
     compiledSource: serialized.compiledSource,

package/.docu/lib/clean.js

@@ -1,6 +1,6 @@
 import {
   logger
-} from "./chunk-I7OBFORY.js";
+} from "./chunk-PL3JZCCY.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/clean.ts

package/.docu/lib/deploy.deno.js

@@ -1,6 +1,6 @@
 import {
   runDeploy
-} from "./chunk-P2P2NB3K.js";
+} from "./chunk-4NI6P6NM.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/deploy.deno.ts

package/.docu/lib/deploy.node.js

@@ -1,6 +1,6 @@
 import {
   runDeploy
-} from "./chunk-P2P2NB3K.js";
+} from "./chunk-4NI6P6NM.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/deploy.node.ts

package/.docu/lib/preview.deno.js

@@ -1,8 +1,8 @@
 import {
   runPreview
-} from "./chunk-74AOEDLW.js";
+} from "./chunk-VJKIFRLV.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-I7OBFORY.js";
+import "./chunk-PL3JZCCY.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/preview.deno.ts

package/.docu/lib/preview.node.js

@@ -1,8 +1,8 @@
 import {
   runPreview
-} from "./chunk-74AOEDLW.js";
+} from "./chunk-VJKIFRLV.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-I7OBFORY.js";
+import "./chunk-PL3JZCCY.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/preview.node.ts

package/.docu/lib/server.deno.js

@@ -1,9 +1,9 @@
 import {
   runServer
-} from "./chunk-Y4PEPREZ.js";
-import "./chunk-WSJC3PRH.js";
+} from "./chunk-UDDWU5NP.js";
+import "./chunk-VW7B64WE.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-I7OBFORY.js";
+import "./chunk-PL3JZCCY.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/server.deno.ts

package/.docu/lib/server.node.js

@@ -1,9 +1,9 @@
 import {
   runServer
-} from "./chunk-Y4PEPREZ.js";
-import "./chunk-WSJC3PRH.js";
+} from "./chunk-UDDWU5NP.js";
+import "./chunk-VW7B64WE.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-I7OBFORY.js";
+import "./chunk-PL3JZCCY.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/server.node.ts

package/.docu/node/deploy.shared.ts

@@ -9,9 +9,13 @@
  */
 
 import { writeFile, mkdir } from "node:fs/promises";
-import { existsSync } from "node:fs";
-import { join } from "node:path";
-import { DIST_DIR, PROJECT_ROOT } from "./paths";
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { DIST_DIR, PROJECT_ROOT, FRAMEWORK_ROOT } from "./paths";
+
+const FLAME_MAJOR = JSON.parse(
+  readFileSync(resolve(FRAMEWORK_ROOT, "package.json"), "utf-8")
+).version.split(".")[0];
 
 const WORKFLOW_DIR = join(PROJECT_ROOT, ".github/workflows");
 const WORKFLOW_FILE = join(WORKFLOW_DIR, "deploy.yml");
@@ -62,7 +66,6 @@ export const NGINX_CONF = `server {
 `;
 
 export const DOCKERIGNORE = `node_modules
-.git
 *.DS_Store
 .docu/dist
 .docu/lib
@@ -140,6 +143,7 @@ export const HEADERS_FILE = `/*
 
 const isDocker = !!process.env.FLAME_DEPLOY_DOCKER;
 const isSilent = !!process.env.FLAME_DEPLOY_SILENT;
+const isCi = !!process.env.FLAME_DEPLOY_CI;
 
 /** Logger that no-ops all non-error output in silent mode. */
 const log = isSilent
@@ -163,18 +167,15 @@ async function runBuild() {
 
 async function writeDockerFiles() {
   const dockerDir = PROJECT_ROOT;
-  const pm = detectPkgManager(dockerDir);
 
   if (!existsSync(join(dockerDir, "Dockerfile"))) {
     await writeFile(
       join(dockerDir, "Dockerfile"),
-      `FROM ${pm.baseImage} AS builder
+      `FROM ghcr.io/docubook/flame-builder:${FLAME_MAJOR} AS builder
 ENV NODE_ENV=production
 WORKDIR /app
-COPY package.json ${pm.lockFile} ./
-RUN ${pm.installCmd}
 COPY . .
-RUN ${pm.runCmd} run build
+RUN flame build
 
 FROM nginx:alpine
 COPY --from=builder /app/.docu/dist /usr/share/nginx/html
@@ -280,6 +281,44 @@ function generateWorkflowYml(): string {
   ].join("\n");
 }
 
+function generateDockerWorkflowYml(): string {
+  const imageName = "ghcr.io/${{ github.repository }}";
+  return [
+    `name: Build & Push Docker Image`,
+    "",
+    "on:",
+    "  push:",
+    "    branches: [main]",
+    "  workflow_dispatch:",
+    "",
+    "permissions:",
+    "  contents: read",
+    "  packages: write",
+    "",
+    "jobs:",
+    "  build:",
+    "    runs-on: ubuntu-latest",
+    "    steps:",
+    "      - uses: actions/checkout@v4",
+    "        with:",
+    "          fetch-depth: 0",
+    "",
+    "      - name: Log in to GHCR",
+    "        uses: docker/login-action@v3",
+    "        with:",
+    "          registry: ghcr.io",
+    "          username: ${{ github.actor }}",
+    "          password: ${{ secrets.GITHUB_TOKEN }}",
+    "",
+    "      - name: Build & push",
+    "        uses: docker/build-push-action@v5",
+    "        with:",
+    "          context: .",
+    `          tags: ${imageName}:latest`,
+    "          push: true",
+  ].join("\n");
+}
+
 async function writeGhaWorkflow() {
   if (!existsSync(WORKFLOW_FILE)) {
     await mkdir(WORKFLOW_DIR, { recursive: true });
@@ -288,6 +327,16 @@ async function writeGhaWorkflow() {
   }
 }
 
+const DOCKER_WORKFLOW_FILE = join(WORKFLOW_DIR, "deploy-docker.yml");
+
+async function writeDockerWorkflow() {
+  if (!existsSync(DOCKER_WORKFLOW_FILE)) {
+    await mkdir(WORKFLOW_DIR, { recursive: true });
+    await writeFile(DOCKER_WORKFLOW_FILE, generateDockerWorkflowYml());
+    log.created("📄 Created .github/workflows/deploy-docker.yml");
+  }
+}
+
 export async function runDeploy(): Promise<void> {
   log.info("📦 Building for production...\n");
   await runBuild();
@@ -298,6 +347,7 @@ export async function runDeploy(): Promise<void> {
 
   if (isDocker) {
     await writeDockerFiles();
+    if (isCi) await writeDockerWorkflow();
   } else {
     await writeGhaWorkflow();
   }
@@ -305,7 +355,13 @@ export async function runDeploy(): Promise<void> {
   log.ok();
   log.out("   Output: .docu/dist/");
   if (isDocker) {
-    log.out("   Run: docker build -t my-docs . && docker run -p 80:80 my-docs");
+    log.out("   Build locally: docker build -t my-docs . && docker run -p 80:80 my-docs");
+    if (isCi) {
+      log.out("   Push to GitHub — CI will build & push Docker image to GHCR");
+      log.out("   Then pull latest image on your hosting platform (Coolify, etc.)");
+    } else {
+      log.out("   For Coolify: connect repo, set build pack to Dockerfile");
+    }
   } else {
     log.out("   Push to GitHub and enable Pages (Settings → Pages → Source: GitHub Actions)");
   }

package/.docu/node/deploy.ts

@@ -8,18 +8,24 @@
  */
 
 import { mkdir } from "node:fs/promises";
-import { existsSync } from "node:fs";
-import { join } from "node:path";
-import { DIST_DIR, PROJECT_ROOT } from "./paths";
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { DIST_DIR, PROJECT_ROOT, FRAMEWORK_ROOT } from "./paths";
 import { HEADERS_FILE, NGINX_CONF, DOCKERIGNORE } from "./deploy.shared";
 
+const FLAME_PKG = JSON.parse(readFileSync(resolve(FRAMEWORK_ROOT, "package.json"), "utf-8"));
+const FLAME_VERSION = FLAME_PKG.version;
+const FLAME_MAJOR = FLAME_VERSION.split(".")[0];
+
 export { HEADERS_FILE, NGINX_CONF, DOCKERIGNORE };
 
 const WORKFLOW_DIR = join(PROJECT_ROOT, ".github/workflows");
 const WORKFLOW_FILE = join(WORKFLOW_DIR, "deploy.yml");
+const DOCKER_WORKFLOW_FILE = join(WORKFLOW_DIR, "deploy-docker.yml");
 
 const isDocker = !!process.env.FLAME_DEPLOY_DOCKER;
 const isSilent = !!process.env.FLAME_DEPLOY_SILENT;
+const isCi = !!process.env.FLAME_DEPLOY_CI;
 
 /** Logger that no-ops all non-error output in silent mode. */
 const log = isSilent
@@ -43,13 +49,11 @@ async function runBuild() {
   }
 }
 
-export const DOCKERFILE_BUN = `FROM oven/bun:1-debian AS builder
+export const DOCKERFILE_BUN = `FROM ghcr.io/docubook/flame-builder:${FLAME_MAJOR} AS builder
 ENV NODE_ENV=production
 WORKDIR /app
-COPY package.json bun.lock ./
-RUN bun install --frozen-lockfile
 COPY . .
-RUN bun run build
+RUN flame build
 
 FROM nginx:alpine
 COPY --from=builder /app/.docu/dist /usr/share/nginx/html
@@ -85,6 +89,52 @@ async function writeGhaWorkflow() {
   }
 }
 
+function generateDockerWorkflowYml(): string {
+  const imageName = "ghcr.io/${{ github.repository }}";
+  return [
+    `name: Build & Push Docker Image`,
+    "",
+    "on:",
+    "  push:",
+    "    branches: [main]",
+    "  workflow_dispatch:",
+    "",
+    "permissions:",
+    "  contents: read",
+    "  packages: write",
+    "",
+    "jobs:",
+    "  build:",
+    "    runs-on: ubuntu-latest",
+    "    steps:",
+    "      - uses: actions/checkout@v4",
+    "        with:",
+    "          fetch-depth: 0",
+    "",
+    "      - name: Log in to GHCR",
+    "        uses: docker/login-action@v3",
+    "        with:",
+    "          registry: ghcr.io",
+    "          username: ${{ github.actor }}",
+    "          password: ${{ secrets.GITHUB_TOKEN }}",
+    "",
+    "      - name: Build & push",
+    "        uses: docker/build-push-action@v5",
+    "        with:",
+    "          context: .",
+    `          tags: ${imageName}:latest`,
+    "          push: true",
+  ].join("\n");
+}
+
+async function writeDockerWorkflow() {
+  if (!existsSync(DOCKER_WORKFLOW_FILE)) {
+    await mkdir(WORKFLOW_DIR, { recursive: true });
+    await Bun.write(DOCKER_WORKFLOW_FILE, generateDockerWorkflowYml());
+    log.created("📄 Created .github/workflows/deploy-docker.yml");
+  }
+}
+
 async function deploy() {
   log.info("📦 Building for production...\n");
   await runBuild();
@@ -95,6 +145,7 @@ async function deploy() {
 
   if (isDocker) {
     await writeDockerFiles();
+    if (isCi) await writeDockerWorkflow();
   } else {
     await writeGhaWorkflow();
   }
@@ -102,7 +153,13 @@ async function deploy() {
   log.ok();
   log.out("   Output: .docu/dist/");
   if (isDocker) {
-    log.out("   Run: docker build -t my-docs . && docker run -p 80:80 my-docs");
+    log.out("   Build locally: docker build -t my-docs . && docker run -p 80:80 my-docs");
+    if (isCi) {
+      log.out("   Push to GitHub — CI will build & push Docker image to GHCR");
+      log.out("   Then pull latest image on your hosting platform (Coolify, etc.)");
+    } else {
+      log.out("   For Coolify: connect repo, set build pack to Dockerfile");
+    }
   } else {
     log.out("   Push to GitHub and enable Pages (Settings → Pages → Source: GitHub Actions)");
   }

package/.docu/node/git.ts

@@ -5,6 +5,7 @@
  */
 
 import { execFile } from "node:child_process";
+import { stat } from "node:fs/promises";
 
 function runGit(args: string[]): Promise<string> {
   return new Promise((resolve, reject) => {
@@ -35,6 +36,19 @@ export async function getGitLastModified(filePath: string): Promise<string | nul
   }
 }
 
+/**
+ * Fallback to filesystem mtime when git is unavailable (shallow clone, no .git, etc.).
+ * Returns ISO 8601 date string or null.
+ */
+export async function getFilesystemMtime(filePath: string): Promise<string | null> {
+  try {
+    const stats = await stat(filePath);
+    return stats.mtime.toISOString();
+  } catch {
+    return null;
+  }
+}
+
 /** Batch git last modified dates for multiple files in a single spawn */
 export async function getGitLastModifiedBatch(filePaths: string[]): Promise<Map<string, string>> {
   const result = new Map<string, string>();

package/.docu/node/mdx.ts

@@ -9,7 +9,7 @@ import {
   MDXRemote,
 } from "@docubook/core";
 import { createMdxComponents } from "@docubook/mdx-content";
-import { getGitLastModified, getGitLastModifiedBatch } from "./git";
+import { getGitLastModified, getGitLastModifiedBatch, getFilesystemMtime } from "./git";
 
 /**
  * Return the value with `.html` appended, or null if the value should be left
@@ -161,6 +161,7 @@ export async function compileMdx(
     frontmatter.date ||
     gitDates?.get(filePath) ||
     (await getGitLastModified(filePath)) ||
+    (await getFilesystemMtime(filePath)) ||
     undefined;
 
   return {

package/bin/cli.js

@@ -58,8 +58,10 @@ if (themeIndex !== -1 && themeIndex + 1 < process.argv.length) {
 }
 const hasDocker = process.argv.includes("--docker");
 const hasSilent = process.argv.includes("--silent");
+const hasCi = process.argv.includes("--ci");
 if (hasDocker) process.env.FLAME_DEPLOY_DOCKER = "1";
 if (hasSilent) process.env.FLAME_DEPLOY_SILENT = "1";
+if (hasCi) process.env.FLAME_DEPLOY_CI = "1";
 
 // Production mode for build/preview/deploy — ensures minified client bundle
 // on all platforms (Coolify, Vercel, etc.) without requiring the user to
@@ -88,7 +90,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.
+    --docker      Generate Docker deployment files (Dockerfile + nginx.conf + .dockerignore). Works with deploy.
+    --ci          Generate CI workflow (.github/workflows/deploy-docker.yml) for auto build & push to GHCR. Use with --docker.
     --silent      Suppress non-essential output. Works with deploy.
 `);
   process.exit(0);
@@ -127,8 +130,8 @@ if (command === "init") {
       pkg.scripts = {
         dev: `${flameCmd} dev`,
         build: `NODE_ENV=production ${flameCmd} build`,
-        preview: `NODE_ENV=production ${flameCmd} preview`,
-        deploy: `NODE_ENV=production ${flameCmd} deploy`,
+        preview: `${flameCmd} preview`,
+        deploy: `${flameCmd} deploy`,
       };
 
       // Generate deno.json with nodeModulesDir for npm compat.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docubook/flame",
-  "version": "1.6.5",
+  "version": "1.7.0",
   "description": "A blazing-fast React + MDX framework powered by Bun, built for modern documentation experiences.",
   "type": "module",
   "bin": {
@@ -55,10 +55,10 @@
     "react-dom": "^19.2.7",
     "unified": "^11.0.0",
     "@docubook/core": "^1.8.2",
-    "@docubook/runt": "^1.0.0",
-    "@docubook/mdx-content": "^3.4.5",
+    "@docubook/ui-react": "^1.0.0",
     "@docubook/themes-colors": "^1.0.2",
-    "@docubook/ui-react": "^1.0.0"
+    "@docubook/runt": "^1.0.0",
+    "@docubook/mdx-content": "^3.4.5"
   },
   "peerDependencies": {
     "@sentry/bun": "^10.0.0"

package/template/docs/guide/deployment.mdx

@@ -13,6 +13,19 @@ npm run deploy       # or: bun run deploy / deno task deploy
 
 This builds the site, adds `.nojekyll`, and generates a GitHub Actions workflow on first run.
 
+## Docker (self-hosted / VPS)
+
+```bash
+flame deploy --docker
+```
+
+Generates `Dockerfile` + `nginx.conf` + `.dockerignore`. Build and run:
+
+```bash
+docker build -t my-docs .
+docker run -p 80:80 my-docs
+```
+
 ## Manual
 
 ```bash

package/template/package.json

@@ -5,8 +5,8 @@
   "scripts": {
     "dev": "flame dev",
     "build": "NODE_ENV=production flame build",
-    "preview": "NODE_ENV=production flame preview",
-    "deploy": "NODE_ENV=production flame deploy"
+    "preview": "flame preview",
+    "deploy": "flame deploy"
   },
   "dependencies": {
     "@docubook/flame": "latest"