create-avalon 0.1.25 → 0.2.1

package/README.md

@@ -19,11 +19,22 @@ bun create avalon
 The CLI walks you through:
 
 - Project name and directory
-- Framework selection (React, Preact, Vue, Svelte, Solid, Lit, Qwik — or multiple)
-- Styling approach (CSS Modules, Tailwind, vanilla CSS)
-- Optional features (API routes, middleware, layouts, MDX)
-- Scheduled jobs (cron) — scaffolds an example task and wires up `nitro.cron`
-- Package manager preference
+- Rendering engine (Preact or React) and island integrations
+- Styling approach (CSS Modules, Tailwind, shadcn)
+- Plugins (SEO, agent optimization). MDX syntax highlighting is always on.
+- Middleware (h3, Hono, Elysia)
+- Deploy target (**Cloudflare Pages**, Netlify, or none)
+- Scheduled jobs (cron)
+
+## Deploy targets
+
+| Choice | What you get |
+|--------|----------------|
+| **Cloudflare Pages** | `wrangler.toml`, `public/_headers`, `DEPLOY.md`, `build` / `preview` / `deploy` scripts. `build.mjs` sets `NITRO_PRESET=cloudflare_pages` when unset. |
+| **Netlify** | `netlify.toml` (`NITRO_PRESET=netlify`), soft SSR redirect, `DEPLOY.md`. |
+| **None** | Node server preset; still gets `build.mjs` + `post-build.mjs`. |
+
+Always run Avalon's post-build (`node post-build.mjs` via `bun run build`) — it patches the Cloudflare worker, CSS manifests, and prerenders HTML.
 
 ## What you get
 
@@ -33,10 +44,11 @@ A ready-to-run Avalon project with file-system routing, islands architecture, an
 my-project/
 ├── app/
 │   ├── modules/
-│   │   └── home/
-│   │       ├── pages/          # File-system routes
-│   │       ├── components/     # Interactive components
-│   │       └── layouts/        # Module layouts
+│   │   ├── main/               # Site root (/)
+│   │   │   ├── pages/          # File-system routes for this module
+│   │   │   ├── components/
+│   │   │   └── layouts/
+│   │   └── about/              # /about — a module name is a URL prefix
 │   └── shared/
 │       ├── layouts/            # Root layout
 │       ├── components/         # Shared components
@@ -46,7 +58,12 @@ my-project/
 │   └── api/                    # API routes
 ├── tasks/                      # Scheduled jobs (cron) — optional
 ├── server/                     # Server config & env
-├── public/                     # Static assets
+├── public/                     # Static assets (+ _headers for Cloudflare)
+├── build.mjs                   # Vite hang workaround + post-build
+├── post-build.mjs              # Avalon production patches / prerender
+├── DEPLOY.md                   # Platform-specific deploy steps
+├── wrangler.toml               # Cloudflare Pages (optional)
+├── netlify.toml                # Netlify (optional)
 ├── vite.config.ts
 └── package.json
 ```

package/dist/cli.js

@@ -4,21 +4,37 @@ var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: () => mod[key],
-        enumerable: true
-      });
+  const to = isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  if (mod && typeof mod === "object" || typeof mod === "function") {
+    for (let key of __getOwnPropNames(mod))
+      if (!__hasOwnProp.call(to, key))
+        __defProp(to, key, {
+          get: __accessProp.bind(mod, key),
+          enumerable: true
+        });
+  }
+  if (canCache)
+    cache.set(mod, to);
   return to;
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 
 // ../../node_modules/.bun/sisteransi@1.0.5/node_modules/sisteransi/src/index.js
-var require_src = __commonJS((exports, module) => {
+var require_src = __commonJS(function(exports, module) {
   var ESC = "\x1B";
   var CSI = `${ESC}[`;
   var beep = "\x07";
@@ -99,17 +115,17 @@ var STYLING_OPTIONS = [
   "tailwind",
   "shadcn"
 ];
-var PLUGINS = [
-  "seo",
-  "agent-optimization",
-  "syntax-highlighting"
-];
+var PLUGINS = ["seo", "agent-optimization"];
 var MIDDLEWARE_OPTIONS = [
   "h3",
   "hono",
   "elysia"
 ];
-var DEPLOY_TARGETS = ["netlify", "none"];
+var DEPLOY_TARGETS = [
+  "cloudflare",
+  "netlify",
+  "none"
+];
 var INTEGRATION_PACKAGES = {
   preact: "@useavalon/preact",
   react: "@useavalon/react",
@@ -123,6 +139,9 @@ var BASE_DIRS = [
   "app/modules/main/pages",
   "app/modules/main/components",
   "app/modules/main/layouts",
+  "app/modules/about/pages",
+  "app/modules/about/components",
+  "app/modules/about/layouts",
   "app/shared/layouts",
   "app/shared/components",
   "app/shared/styles",
@@ -209,8 +228,8 @@ function resolveConfigNonInteractive(args) {
   if (styling === "shadcn" && core !== "react") {
     throw new CliArgError("--styling=shadcn requires --core=react (shadcn is Radix/React based).");
   }
-  if (core === "react" && !integrations.includes("react")) {
-    integrations.push("react");
+  if (!integrations.includes(core)) {
+    integrations.push(core);
   }
   return {
     projectName: args.projectName ?? ".",
@@ -580,82 +599,6 @@ class B {
     }
   }
 }
-function wt(t, e) {
-  if (t === undefined || e.length === 0)
-    return 0;
-  const s = e.findIndex((i) => i.value === t);
-  return s !== -1 ? s : 0;
-}
-function Dt(t, e) {
-  return (e.label ?? String(e.value)).toLowerCase().includes(t.toLowerCase());
-}
-function St(t, e) {
-  if (e)
-    return t ? e : e[0];
-}
-
-class Vt extends B {
-  filteredOptions;
-  multiple;
-  isNavigating = false;
-  selectedValues = [];
-  focusedValue;
-  #t = 0;
-  #s = "";
-  #i;
-  #e;
-  get cursor() {
-    return this.#t;
-  }
-  get userInputWithCursor() {
-    if (!this.userInput)
-      return D(["inverse", "hidden"], "_");
-    if (this._cursor >= this.userInput.length)
-      return `${this.userInput}█`;
-    const e = this.userInput.slice(0, this._cursor), [s, ...i] = this.userInput.slice(this._cursor);
-    return `${e}${D("inverse", s)}${i.join("")}`;
-  }
-  get options() {
-    return typeof this.#e == "function" ? this.#e() : this.#e;
-  }
-  constructor(e) {
-    super(e), this.#e = e.options;
-    const s = this.options;
-    this.filteredOptions = [...s], this.multiple = e.multiple === true, this.#i = e.filter ?? Dt;
-    let i;
-    if (e.initialValue && Array.isArray(e.initialValue) ? this.multiple ? i = e.initialValue : i = e.initialValue.slice(0, 1) : !this.multiple && this.options.length > 0 && (i = [this.options[0].value]), i)
-      for (const r of i) {
-        const n = s.findIndex((u) => u.value === r);
-        n !== -1 && (this.toggleSelected(r), this.#t = n);
-      }
-    this.focusedValue = this.options[this.#t]?.value, this.on("key", (r, n) => this.#r(r, n)), this.on("userInput", (r) => this.#n(r));
-  }
-  _isActionKey(e, s) {
-    return e === "\t" || this.multiple && this.isNavigating && s.name === "space" && e !== undefined && e !== "";
-  }
-  #r(e, s) {
-    const i = s.name === "up", r = s.name === "down", n = s.name === "return";
-    i || r ? (this.#t = x(this.#t, i ? -1 : 1, this.filteredOptions), this.focusedValue = this.filteredOptions[this.#t]?.value, this.multiple || (this.selectedValues = [this.focusedValue]), this.isNavigating = true) : n ? this.value = St(this.multiple, this.selectedValues) : this.multiple ? this.focusedValue !== undefined && (s.name === "tab" || this.isNavigating && s.name === "space") ? this.toggleSelected(this.focusedValue) : this.isNavigating = false : (this.focusedValue && (this.selectedValues = [this.focusedValue]), this.isNavigating = false);
-  }
-  deselectAll() {
-    this.selectedValues = [];
-  }
-  toggleSelected(e) {
-    this.filteredOptions.length !== 0 && (this.multiple ? this.selectedValues.includes(e) ? this.selectedValues = this.selectedValues.filter((s) => s !== e) : this.selectedValues = [...this.selectedValues, e] : this.selectedValues = [e]);
-  }
-  #n(e) {
-    if (e !== this.#s) {
-      this.#s = e;
-      const s = this.options;
-      e ? this.filteredOptions = s.filter((n) => this.#i(e, n)) : this.filteredOptions = [...s];
-      const i = wt(this.focusedValue, this.filteredOptions);
-      this.#t = x(i, 0, this.filteredOptions);
-      const r = this.filteredOptions[this.#t];
-      r && !r.disabled ? this.focusedValue = r.value : this.focusedValue = undefined, this.multiple || (this.focusedValue !== undefined ? this.toggleSelected(this.focusedValue) : this.deselectAll());
-    }
-  }
-}
-
 class kt extends B {
   get cursor() {
     return this.value ? 0 : 1;
@@ -673,54 +616,6 @@ class kt extends B {
     });
   }
 }
-
-class yt extends B {
-  options;
-  cursor = 0;
-  #t;
-  getGroupItems(e) {
-    return this.options.filter((s) => s.group === e);
-  }
-  isGroupSelected(e) {
-    const s = this.getGroupItems(e), i = this.value;
-    return i === undefined ? false : s.every((r) => i.includes(r.value));
-  }
-  toggleValue() {
-    const e = this.options[this.cursor];
-    if (this.value === undefined && (this.value = []), e.group === true) {
-      const s = e.value, i = this.getGroupItems(s);
-      this.isGroupSelected(s) ? this.value = this.value.filter((r) => i.findIndex((n) => n.value === r) === -1) : this.value = [...this.value, ...i.map((r) => r.value)], this.value = Array.from(new Set(this.value));
-    } else {
-      const s = this.value.includes(e.value);
-      this.value = s ? this.value.filter((i) => i !== e.value) : [...this.value, e.value];
-    }
-  }
-  constructor(e) {
-    super(e, false);
-    const { options: s } = e;
-    this.#t = e.selectableGroups !== false, this.options = Object.entries(s).flatMap(([i, r]) => [{ value: i, group: true, label: i }, ...r.map((n) => ({ ...n, group: i }))]), this.value = [...e.initialValues ?? []], this.cursor = Math.max(this.options.findIndex(({ value: i }) => i === e.cursorAt), this.#t ? 0 : 1), this.on("cursor", (i) => {
-      switch (i) {
-        case "left":
-        case "up": {
-          this.cursor = this.cursor === 0 ? this.options.length - 1 : this.cursor - 1;
-          const r = this.options[this.cursor]?.group === true;
-          !this.#t && r && (this.cursor = this.cursor === 0 ? this.options.length - 1 : this.cursor - 1);
-          break;
-        }
-        case "down":
-        case "right": {
-          this.cursor = this.cursor === this.options.length - 1 ? 0 : this.cursor + 1;
-          const r = this.options[this.cursor]?.group === true;
-          !this.#t && r && (this.cursor = this.cursor === this.options.length - 1 ? 0 : this.cursor + 1);
-          break;
-        }
-        case "space":
-          this.toggleValue();
-          break;
-      }
-    });
-  }
-}
 var Lt = class extends B {
   options;
   cursor = 0;
@@ -889,59 +784,59 @@ var Ft2 = /\p{M}+/gu;
 var yt2 = { limit: 1 / 0, ellipsis: "" };
 var Le = (e, r = {}, s = {}) => {
   const i = r.limit ?? 1 / 0, a = r.ellipsis ?? "", o = r?.ellipsisWidth ?? (a ? Le(a, yt2, s).width : 0), u = s.ansiWidth ?? 0, l = s.controlWidth ?? 0, n = s.tabWidth ?? 8, c = s.ambiguousWidth ?? 1, p = s.emojiWidth ?? 2, f = s.fullWidthWidth ?? 2, g = s.regularWidth ?? 1, E = s.wideWidth ?? 2;
-  let $ = 0, m = 0, d = e.length, F = 0, y2 = false, v = d, C = Math.max(0, i - o), A = 0, b = 0, w = 0, S2 = 0;
+  let $ = 0, m = 0, d = e.length, F = 0, y = false, v = d, C = Math.max(0, i - o), A = 0, b = 0, w = 0, S = 0;
   e:
     for (;; ) {
       if (b > A || m >= d && m > $) {
-        const T2 = e.slice(A, b) || e.slice($, m);
+        const T = e.slice(A, b) || e.slice($, m);
         F = 0;
-        for (const M2 of T2.replaceAll(Ft2, "")) {
-          const O2 = M2.codePointAt(0) || 0;
-          if (gt2(O2) ? S2 = f : ft2(O2) ? S2 = E : c !== g && mt2(O2) ? S2 = c : S2 = g, w + S2 > C && (v = Math.min(v, Math.max(A, $) + F)), w + S2 > i) {
-            y2 = true;
+        for (const M of T.replaceAll(Ft2, "")) {
+          const O = M.codePointAt(0) || 0;
+          if (gt2(O) ? S = f : ft2(O) ? S = E : c !== g && mt2(O) ? S = c : S = g, w + S > C && (v = Math.min(v, Math.max(A, $) + F)), w + S > i) {
+            y = true;
             break e;
           }
-          F += M2.length, w += S2;
+          F += M.length, w += S;
         }
         A = b = 0;
       }
       if (m >= d)
         break;
       if (ne.lastIndex = m, ne.test(e)) {
-        if (F = ne.lastIndex - m, S2 = F * g, w + S2 > C && (v = Math.min(v, m + Math.floor((C - w) / g))), w + S2 > i) {
-          y2 = true;
+        if (F = ne.lastIndex - m, S = F * g, w + S > C && (v = Math.min(v, m + Math.floor((C - w) / g))), w + S > i) {
+          y = true;
           break;
         }
-        w += S2, A = $, b = m, m = $ = ne.lastIndex;
+        w += S, A = $, b = m, m = $ = ne.lastIndex;
         continue;
       }
       if (we.lastIndex = m, we.test(e)) {
         if (w + u > C && (v = Math.min(v, m)), w + u > i) {
-          y2 = true;
+          y = true;
           break;
         }
         w += u, A = $, b = m, m = $ = we.lastIndex;
         continue;
       }
       if (re.lastIndex = m, re.test(e)) {
-        if (F = re.lastIndex - m, S2 = F * l, w + S2 > C && (v = Math.min(v, m + Math.floor((C - w) / l))), w + S2 > i) {
-          y2 = true;
+        if (F = re.lastIndex - m, S = F * l, w + S > C && (v = Math.min(v, m + Math.floor((C - w) / l))), w + S > i) {
+          y = true;
           break;
         }
-        w += S2, A = $, b = m, m = $ = re.lastIndex;
+        w += S, A = $, b = m, m = $ = re.lastIndex;
         continue;
       }
       if (ie.lastIndex = m, ie.test(e)) {
-        if (F = ie.lastIndex - m, S2 = F * n, w + S2 > C && (v = Math.min(v, m + Math.floor((C - w) / n))), w + S2 > i) {
-          y2 = true;
+        if (F = ie.lastIndex - m, S = F * n, w + S > C && (v = Math.min(v, m + Math.floor((C - w) / n))), w + S > i) {
+          y = true;
           break;
         }
-        w += S2, A = $, b = m, m = $ = ie.lastIndex;
+        w += S, A = $, b = m, m = $ = ie.lastIndex;
         continue;
       }
       if (Ae.lastIndex = m, Ae.test(e)) {
         if (w + p > C && (v = Math.min(v, m)), w + p > i) {
-          y2 = true;
+          y = true;
           break;
         }
         w += p, A = $, b = m, m = $ = Ae.lastIndex;
@@ -949,7 +844,7 @@ var Le = (e, r = {}, s = {}) => {
       }
       m += 1;
     }
-  return { width: y2 ? C : w, index: y2 ? v : d, truncated: y2, ellipsed: y2 && i >= o };
+  return { width: y ? C : w, index: y ? v : d, truncated: y, ellipsed: y && i >= o };
 };
 var Et2 = { limit: 1 / 0, ellipsis: "", ellipsisWidth: 0 };
 var D2 = (e, r = {}) => Le(e, Et2, r).width;
@@ -958,9 +853,9 @@ var je = "›";
 var vt2 = 39;
 var Ce = "\x07";
 var ke = "[";
-var wt2 = "]";
+var wt = "]";
 var Ve = "m";
-var Se = `${wt2}8;;`;
+var Se = `${wt}8;;`;
 var He = new RegExp(`(?:\\${ke}(?<code>\\d+)m|\\${Se}(?<uri>.*)${Ce})`, "y");
 var At2 = (e) => {
   if (e >= 30 && e <= 37 || e >= 90 && e <= 97)
@@ -994,7 +889,7 @@ var Ie = (e, r, s) => {
   }
   u = e.at(-1), !l && u !== undefined && u.length > 0 && e.length > 1 && (e[e.length - 2] += e.pop());
 };
-var St2 = (e) => {
+var St = (e) => {
   const r = e.split(" ");
   let s = r.length;
   for (;s > 0 && !(D2(r[s - 1]) > 0); )
@@ -1011,8 +906,8 @@ var It2 = (e, r, s = {}) => {
     s.trim !== false && (n[n.length - 1] = (n.at(-1) ?? "").trimStart());
     let d = D2(n.at(-1) ?? "");
     if ($ !== 0 && (d >= r && (s.wordWrap === false || s.trim === false) && (n.push(""), d = 0), (d > 0 || s.trim === false) && (n[n.length - 1] += " ", d++)), s.hard && l[$] > r) {
-      const F = r - d, y2 = 1 + Math.floor((l[$] - F - 1) / r);
-      Math.floor((l[$] - 1) / r) < y2 && n.push(""), Ie(n, m, r);
+      const F = r - d, y = 1 + Math.floor((l[$] - F - 1) / r);
+      Math.floor((l[$] - 1) / r) < y && n.push(""), Ie(n, m, r);
       continue;
     }
     if (d + l[$] > r && d > 0 && l[$] > 0) {
@@ -1028,7 +923,7 @@ var It2 = (e, r, s = {}) => {
     }
     n[n.length - 1] += m;
   }
-  s.trim !== false && (n = n.map(($) => St2($)));
+  s.trim !== false && (n = n.map(($) => St($)));
   const c = n.join(`
 `), p = c[Symbol.iterator]();
   let f = p.next(), g = p.next(), E = 0;
@@ -1036,12 +931,12 @@ var It2 = (e, r, s = {}) => {
     const $ = f.value, m = g.value;
     if (i += $, $ === ae || $ === je) {
       He.lastIndex = E + 1;
-      const y2 = He.exec(c)?.groups;
-      if (y2?.code !== undefined) {
-        const v = Number.parseFloat(y2.code);
+      const y = He.exec(c)?.groups;
+      if (y?.code !== undefined) {
+        const v = Number.parseFloat(y.code);
         a = v === vt2 ? undefined : v;
       } else
-        y2?.uri !== undefined && (o = y2.uri.length === 0 ? undefined : y2.uri);
+        y?.uri !== undefined && (o = y.uri.length === 0 ? undefined : y.uri);
     }
     const d = a ? At2(a) : undefined;
     m === `
@@ -1074,16 +969,16 @@ var X2 = ({ cursor: e, options: r, style: s, output: i = process.stdout, maxItem
   const m = Math.min(g + f, r.length), d = [];
   let F = 0;
   E && F++, $ && F++;
-  const y2 = g + (E ? 1 : 0), v = m - ($ ? 1 : 0);
-  for (let A = y2;A < v; A++) {
+  const y = g + (E ? 1 : 0), v = m - ($ ? 1 : 0);
+  for (let A = y;A < v; A++) {
     const b = J(s(r[A], A === e), l, { hard: true, trim: false }).split(`
 `);
     d.push(b), F += b.length;
   }
   if (F > p) {
     let A = 0, b = 0, w = F;
-    const S2 = e - y2, T2 = (M2, O2) => bt2(d, w, M2, O2, p);
-    E ? ({ lineCount: w, removals: A } = T2(0, S2), w > p && ({ lineCount: w, removals: b } = T2(S2 + 1, d.length))) : ({ lineCount: w, removals: b } = T2(S2 + 1, d.length), w > p && ({ lineCount: w, removals: A } = T2(0, S2))), A > 0 && (E = true, d.splice(0, A)), b > 0 && ($ = true, d.splice(d.length - b, b));
+    const S = e - y, T = (M, O) => bt2(d, w, M, O, p);
+    E ? ({ lineCount: w, removals: A } = T(0, S), w > p && ({ lineCount: w, removals: b } = T(S + 1, d.length))) : ({ lineCount: w, removals: b } = T(S + 1, d.length), w > p && ({ lineCount: w, removals: A } = T(0, S))), A > 0 && (E = true, d.splice(0, A)), b > 0 && ($ = true, d.splice(d.length - b, b));
   }
   const C = [];
   E && C.push(c);
@@ -1350,11 +1245,6 @@ async function collectProjectConfig(initialName) {
         value: "agent-optimization",
         label: "agent-optimization",
         hint: "LLM/AI optimization (llms.txt, markdown, sitemap)"
-      },
-      {
-        value: "syntax-highlighting",
-        label: "syntax-highlighting",
-        hint: "Code block highlighting for MDX (rehype-highlight)"
       }
     ],
     initialValues: ["seo"],
@@ -1379,12 +1269,17 @@ async function collectProjectConfig(initialName) {
   const deployResult = await Jt({
     message: "Where will you deploy?",
     options: [
+      {
+        value: "cloudflare",
+        label: "Cloudflare Pages",
+        hint: "wrangler.toml, public/_headers, build + deploy scripts"
+      },
       {
         value: "netlify",
         label: "Netlify",
-        hint: "Generates netlify.toml, build.mjs, post-build.mjs"
+        hint: "netlify.toml, build.mjs, post-build.mjs"
       },
-      { value: "none", label: "None / Other", hint: "Node server preset, no deploy config" }
+      { value: "none", label: "None / Other", hint: "Node server preset, no platform config" }
     ]
   });
   if (Ct(deployResult)) {
@@ -1401,8 +1296,8 @@ async function collectProjectConfig(initialName) {
   }
   const core = coreResult;
   const integrations = integrationsResult;
-  if (core === "react" && !integrations.includes("react")) {
-    integrations.push("react");
+  if (!integrations.includes(core)) {
+    integrations.push(core);
   }
   return {
     projectName,
@@ -1456,6 +1351,10 @@ export default defineCronJob({
 }
 
 // src/templates/deploy.ts
+function cloudflareProjectName(projectName) {
+  const slug = projectName.toLowerCase().replaceAll(/[^a-z0-9-]+/g, "-").replaceAll(/-+/g, "-").replaceAll(/^-|-$/g, "");
+  return slug || "avalon-app";
+}
 function generateNetlifyToml(_config) {
   return `[build]
   base = "."
@@ -1480,6 +1379,117 @@ function generateNetlifyToml(_config) {
   status = 200
 `;
 }
+function generateWranglerToml(config) {
+  const name = cloudflareProjectName(config.projectName);
+  return `# Cloudflare Pages — production output is dist/_worker.js + static assets.
+# Date must be >= 2025-09-15 so nodejs_compat includes \`node:fs\` (needed by the Nitro worker).
+name = "${name}"
+compatibility_date = "2026-09-04"
+compatibility_flags = ["nodejs_compat", "enable_nodejs_fs_module"]
+pages_build_output_dir = "./dist"
+`;
+}
+function generateCloudflareHeaders() {
+  return `# Cloudflare Pages static headers (Worker routeRules still apply to SSR).
+/*.html
+  Cache-Control: public, max-age=3600, s-maxage=31536000
+
+/
+  Cache-Control: public, max-age=3600, s-maxage=31536000
+
+/islands/*
+  Cache-Control: public, max-age=0, must-revalidate
+`;
+}
+function generateDeployReadme(config) {
+  if (config.deploy === "cloudflare") {
+    const name = cloudflareProjectName(config.projectName);
+    return `# Deploying to Cloudflare Pages
+
+This project is set up for \`NITRO_PRESET=cloudflare_pages\`.
+
+## Build
+
+\`\`\`bash
+bun run build
+\`\`\`
+
+\`build.mjs\` detects \`wrangler.toml\` and sets the Nitro preset when \`NITRO_PRESET\` is unset.
+Avalon's post-build patches the Cloudflare worker (DOM stub, CSS manifest, \`_routes.json\`).
+
+## Preview locally
+
+\`\`\`bash
+bun run preview
+\`\`\`
+
+## Deploy
+
+1. Create an API token with **Account → Cloudflare Pages → Edit** and **Account Settings → Read**.
+2. Set \`CLOUDFLARE_API_TOKEN\` and \`CLOUDFLARE_ACCOUNT_ID\` in your environment (or CI secrets).
+3. Create the Pages project once (Wrangler 4 does not auto-create):
+
+\`\`\`bash
+bunx wrangler@4 pages project create ${name} \\
+  --production-branch=main \\
+  --compatibility-flags=nodejs_compat \\
+  --compatibility-date=2026-09-04
+\`\`\`
+
+4. Deploy:
+
+\`\`\`bash
+bun run deploy
+\`\`\`
+
+Prefer **one** deployer (e.g. GitHub Actions with Wrangler). If you also connect the
+GitHub repo in the Cloudflare dashboard, disable Cloudflare's own build to avoid
+double deploys.
+
+Do not rely on Cloudflare's Git integration to run \`vite build\` without Avalon's
+\`post-build.mjs\` — prerendered CSS and worker patches will be missing.
+`;
+  }
+  if (config.deploy === "netlify") {
+    return `# Deploying to Netlify
+
+This project is set up for \`NITRO_PRESET=netlify\` via \`netlify.toml\`.
+
+## Build
+
+\`\`\`bash
+bun run build
+\`\`\`
+
+Or connect the repo in Netlify — \`netlify.toml\` runs \`bun install && bun build.mjs\`
+and publishes \`dist/\`. Avalon's post-build copies the server function and prerenders routes.
+
+## Preview locally
+
+\`\`\`bash
+bun run preview
+\`\`\`
+
+## Notes
+
+- Functions live under \`.netlify/functions-internal\` (\`node_bundler = "none"\`).
+- The \`/*\` → \`/.netlify/functions/server\` redirect is a soft SSR fallback: static
+  prerendered HTML in \`dist/\` is served first when present.
+`;
+  }
+  return `# Deploy
+
+No platform config was generated. Build with:
+
+\`\`\`bash
+bun run build
+\`\`\`
+
+Default Nitro preset is \`node_server\` (\`.output/server\`). Set \`NITRO_PRESET\` for
+other targets (\`netlify\`, \`cloudflare_pages\`, \`vercel\`, …) and add the matching
+platform config — or re-run \`create-avalon\` with a deploy target.
+`;
+}
 function generateBuildMjs() {
   return `/**
  * Build wrapper.
@@ -1487,20 +1497,49 @@ function generateBuildMjs() {
  * Vite/Nitro leaves open handles after the build completes, preventing
  * the Node process from exiting. This wrapper detects when the build
  * output is ready, kills the entire process group, then runs post-build.
+ *
+ * When NITRO_PRESET is unset, defaults from wrangler.toml / netlify.toml
+ * so local \`bun run build\` matches the chosen create-avalon deploy target.
  */
 
 import { spawn, execSync } from 'node:child_process';
-import { existsSync, rmSync } from 'node:fs';
+import { existsSync, rmSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 
 const CWD = process.cwd();
 const NITRO_JSON = join(CWD, '.netlify', 'functions-internal', 'nitro.json');
 const SERVER_MJS = join(CWD, '.netlify', 'functions-internal', 'server', 'server.mjs');
 const OUTPUT_SSR = join(CWD, '.output', 'server', '_ssr', 'ssr.mjs');
+const CF_WORKER = join(CWD, 'dist', '_worker.js');
+
+if (!process.env.NITRO_PRESET) {
+  if (existsSync(join(CWD, 'wrangler.toml'))) {
+    process.env.NITRO_PRESET = 'cloudflare_pages';
+  } else if (existsSync(join(CWD, 'netlify.toml'))) {
+    process.env.NITRO_PRESET = 'netlify';
+  }
+}
+
+/** True when Nitro finished a Cloudflare worker file, not an empty client-build directory. */
+function isCloudflareWorkerReady() {
+  try {
+    const st = statSync(CF_WORKER);
+    if (st.isFile()) return true;
+    if (st.isDirectory()) {
+      return existsSync(join(CF_WORKER, 'index.js')) || existsSync(join(CF_WORKER, 'index.mjs'));
+    }
+  } catch {
+    return false;
+  }
+  return false;
+}
 
 console.log('[build] Starting vite build...');
+if (process.env.NITRO_PRESET) {
+  console.log(\`[build] NITRO_PRESET=\${process.env.NITRO_PRESET}\`);
+}
 
-for (const dir of ['.netlify', '.output', 'netlify']) {
+for (const dir of ['.netlify', '.output', 'netlify', 'dist']) {
   const full = join(CWD, dir);
   if (existsSync(full)) {
     rmSync(full, { recursive: true, force: true });
@@ -1512,10 +1551,13 @@ const child = spawn('bunx', ['--bun', 'vite', 'build'], {
   cwd: CWD,
   stdio: 'inherit',
   detached: true,
+  env: process.env,
 });
 
 const childPid = child.pid;
 let done = false;
+let killedEarly = false;
+let viteExitCode = 0;
 
 function killTree() {
   try { process.kill(-childPid, 'SIGKILL'); } catch {}
@@ -1527,29 +1569,40 @@ function finish() {
   done = true;
   clearInterval(poll);
   clearTimeout(absoluteTimeout);
-  killTree();
+
+  if (killedEarly) killTree();
 
   setTimeout(() => {
     console.log('[build] Running post-build...');
     try {
-      execSync('node post-build.mjs', { cwd: CWD, stdio: 'inherit', timeout: 120_000 });
+      execSync('node post-build.mjs', { cwd: CWD, stdio: 'inherit', timeout: 120_000, env: process.env });
     } catch (err) {
-      console.error('[build] post-build warning:', err.message);
+      console.error('[build] post-build failed:', err.message);
+      process.exit(1);
     }
 
     const V1_SERVER = join(CWD, '.netlify', 'v1', 'functions', 'server', 'server.mjs');
-    if (existsSync(V1_SERVER)) console.log('[build] ✅ Server function found (v1 API)');
+    const cloudflareReady = isCloudflareWorkerReady();
+    const ok =
+      cloudflareReady ||
+      existsSync(V1_SERVER) ||
+      existsSync(SERVER_MJS) ||
+      existsSync(OUTPUT_SSR);
+    if (cloudflareReady) console.log('[build] ✅ Cloudflare worker found (dist/_worker.js)');
+    else if (existsSync(V1_SERVER)) console.log('[build] ✅ Server function found (v1 API)');
     else if (existsSync(SERVER_MJS)) console.log('[build] ✅ Server function found (legacy)');
     else if (existsSync(OUTPUT_SSR)) console.log('[build] ✅ SSR bundle found');
     else console.error('[build] ❌ No server output found');
 
+    if (!ok) process.exit(1);
     console.log('[build] ✅ Complete');
-    process.exit(0);
+    process.exit(killedEarly || viteExitCode === 0 ? 0 : viteExitCode);
   }, 500);
 }
 
 child.on('exit', (code) => {
   console.log(\`[build] vite build exited with code \${code}\`);
+  viteExitCode = code ?? (killedEarly ? 0 : 1);
   finish();
 });
 
@@ -1559,10 +1612,14 @@ child.on('error', (err) => {
 });
 
 const poll = setInterval(() => {
+  // Cloudflare \`_worker.js\` appears during the client build; killing then
+  // aborts SSR. Only force-stop the Netlify/Node hang.
   const netlifyReady = existsSync(NITRO_JSON) && existsSync(SERVER_MJS);
   const nodeServerReady = existsSync(OUTPUT_SSR);
   if (netlifyReady || nodeServerReady) {
-    console.log(\`[build] Output detected (\${netlifyReady ? 'netlify' : 'node-server'}), waiting 3s for final writes...\`);
+    killedEarly = true;
+    const kind = netlifyReady ? 'netlify' : 'node-server';
+    console.log(\`[build] Output detected (\${kind}), waiting 3s for final writes...\`);
     clearInterval(poll);
     setTimeout(finish, 3_000);
   }
@@ -1570,6 +1627,7 @@ const poll = setInterval(() => {
 
 const absoluteTimeout = setTimeout(() => {
   console.error('[build] Timeout — killing build');
+  killedEarly = true;
   finish();
 }, 240_000);
 `;
@@ -1630,6 +1688,22 @@ User-agent: AI2Bot
 Allow: /
 `;
 }
+function generateGitignore(_config) {
+  return [
+    "node_modules/",
+    "dist/",
+    ".output/",
+    ".netlify/",
+    ".wrangler/",
+    "*.log",
+    ".DS_Store",
+    ".env",
+    ".env.*",
+    "!.env.example",
+    ""
+  ].join(`
+`);
+}
 
 // src/templates/favicon.ts
 var FAVICON_BASE64 = "AAABAAEAICAAAAEAIACoEAAAFgAAACgAAAAgAAAAQAAAAAEAIAAAAAAAABAAACMuAAAjLgAAAAAAAAAAAAAAAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8BAAD/AQAA/wEAAP8BAAD/AQAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wIBAP9DIQr/f0AT/4BAE/+AQBP/f0AT/34/E/9+PxL/fj8T/39AE/+BQBP/cjkR/yAQBf8GAwH/Wy4N/4hEFP+HRBT/h0QU/4dEFP+GQxT/hUMU/4VDE/+EQhP/hEIT/2QzD/8PCAL/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/KxYG/8BgHP/YbSD/12wg/9dsIP/XbCD/12wg/9dsIP/XbCD/12wg/9dsIP/YbSD/iEUU/1AoDP/OaB7/2Gwg/9dsIP/XbCD/12wg/9dsIP/XbCD/12wg/9dsIP/XbCD/1Gsf/18wDv8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8+Hwn/z2ge/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9RqH//FYx3/jUcV/9BpH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Vax//r1ga/xgMBP8AAAD/AAAA/wAAAP8AAAD/AAAA/xEIAv+lUxj/1msf/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9VrH/+iURj/tlsb/9VrH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//XzAO/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/1UrDP/RaR//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//1Gof/8RiHf+ZTRb/0Wkf/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9VrH/+tVxn/FgsD/wAAAP8AAAD/AAAA/wAAAP8AAAD/EwoD/6lVGf/Wax//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//1Gsf/6FRGP+6XRv/1Wsf/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9BoH/9BIQr/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/Wi0N/9JqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Uax//wmId/51PF//Sah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Vax//ul4b/yQSBf8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8WCwP/rVcZ/9VrH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Uah//olEY/71fHP/Uax//02of/9NqH//Tah//02of/9NqH//Tah//02of/9FpH/9eLw7/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP9fLw7/02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9RrH//BYRz/oFEX/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Wax//l0wW/w0HAv8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/xgMBP+wWRr/1Wsf/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH/+iUhj/wWEc/9RrH//Tah//02of/9NqH//Tah//1Gsf/8BhHP8xGQf/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/2QyD//Uah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//1Gsf/8BgHP+kUxj/02of/9NqH//Tah//02of/9NqH//Tah//ZzQP/wEAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/HA4E/7RaGv/Vax//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/6NSGP/EYh3/1Gof/9NqH//Tah//1msf/59QF/8RCQP/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/aTUP/9RrH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Uax//v2Ac/6hVGf/Uah//02of/9RrH//FYx3/ORwI/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8fDwT/t1wb/9VrH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Sah//pVMY/8dkHf/Uax//1Gsf/3E5EP8CAQD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP9uNxD/1Wsf/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9RrH/+8Xhz/m04X/81nHv+dTxf/FgsD/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/yIRBf+6Xhv/1Wsf/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//1Gsf/79gHP8yGQf/MxoI/xcMA/8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/3Q6Ef/Vax//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Uax//dDoR/wMBAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/JhMG/71fHP/Uax//02of/9NqH//Tah//02of/9NqH//Tah//1msf/6dUGP8XDAP/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8BAQD/eT0S/9ZrH//Tah//02of/9NqH//Tah//02of/9RqH//IZB3/QCAJ/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8qFQb/wGEc/9RrH//Tah//02of/9NqH//Tah//1Gsf/3c8Ev8DAgH/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wIBAP9+PxP/1msf/9NqH//Tah//02of/9ZrH/+nVBn/GAwE/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/y4XB//DYh3/1Gsf/9NqH//Uax//xWMd/zweCf8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AwIA/4NCE//Wax//02of/9NqH/9rNhD/AgEA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/MhkH/8VjHf/XbCD/mk4X/xAIAv8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8FAgH/iUUU/8BhHP8vGAf/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8yGQf/TygM/wEAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wEBAP8CAQD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=";
@@ -1651,8 +1725,8 @@ function generateRootLayout(config) {
 `)}
 
 export default async function RootLayout({ children, frontmatter }: Readonly<LayoutProps>) {
-  const title = frontmatter?.title ?? '${safeName}';
-  const description = frontmatter?.description ?? '';
+  const title = typeof frontmatter?.title === 'string' ? frontmatter.title : '${safeName}';
+  const description = typeof frontmatter?.description === 'string' ? frontmatter.description : '';
 
   return (
     <html lang="en">
@@ -1660,8 +1734,9 @@ export default async function RootLayout({ children, frontmatter }: Readonly<Lay
         <meta charset="UTF-8" />
         <meta name="viewport" content="width=device-width, initial-scale=1.0" />
         <title>{title}</title>
-        {description && <meta name="description" content={description} />}
+        {description ? <meta name="description" content={description} /> : null}
         <link rel="icon" href="/favicon.ico" />
+        <link rel="stylesheet" href="/syntax-highlighting.css" />
       </head>
       <body style={{ margin: 0 }}>
         {children}
@@ -1679,6 +1754,14 @@ export default async function MainLayout({ children }: Readonly<LayoutProps>) {
 }
 `;
 }
+function generateAboutLayout(_config) {
+  return `import type { LayoutProps } from '@useavalon/avalon';
+
+export default async function AboutLayout({ children }: Readonly<LayoutProps>) {
+  return <>{children}</>;
+}
+`;
+}
 
 // src/templates/middleware.ts
 function generateSampleMiddleware(_config) {
@@ -1709,7 +1792,9 @@ function generatePackageJson(config) {
   const dependencies = {
     "@useavalon/avalon": "latest"
   };
-  for (const integration of config.integrations) {
+  const selectedIntegrations = new Set(config.integrations);
+  selectedIntegrations.add(config.core);
+  for (const integration of selectedIntegrations) {
     dependencies[INTEGRATION_PACKAGES[integration]] = "latest";
     Object.assign(dependencies, INTEGRATION_RUNTIME_DEPS[integration]);
   }
@@ -1719,9 +1804,7 @@ function generatePackageJson(config) {
   if (config.plugins.includes("agent-optimization")) {
     dependencies["@useavalon/agent-optimization"] = "latest";
   }
-  if (config.plugins.includes("syntax-highlighting")) {
-    dependencies["rehype-highlight"] = "latest";
-  }
+  dependencies["rehype-highlight"] = "latest";
   switch (config.middleware) {
     case "hono":
       dependencies.hono = "latest";
@@ -1731,10 +1814,10 @@ function generatePackageJson(config) {
       break;
   }
   const devDependencies = {
-    vite: "latest",
-    typescript: "latest",
-    nitro: "latest",
-    "vite-imagetools": "latest"
+    vite: "^8.0.0",
+    typescript: "^5.0.0",
+    nitro: "^3.0.260311-beta",
+    "vite-imagetools": "^7.0.0"
   };
   switch (config.styling) {
     case "tailwind":
@@ -1749,15 +1832,21 @@ function generatePackageJson(config) {
       dependencies.clsx = "^2.1.1";
       break;
   }
+  const scripts = {
+    dev: "bunx --bun vite dev",
+    build: "node build.mjs",
+    preview: "node .output/server/index.mjs"
+  };
+  if (config.deploy === "cloudflare") {
+    const name = cloudflareProjectName(config.projectName);
+    scripts.preview = "bunx wrangler@4 pages dev dist";
+    scripts.deploy = `bunx wrangler@4 pages deploy --project-name=${name}`;
+  }
   const pkg = {
     name: config.projectName,
     type: "module",
     private: true,
-    scripts: {
-      dev: "bunx --bun vite dev",
-      build: "node build.mjs",
-      preview: "node .output/server/index.mjs"
-    },
+    scripts,
     dependencies,
     devDependencies
   };
@@ -1805,6 +1894,10 @@ export default async function HomePage() {
         <code style={{ display: 'block', padding: '0.6rem 1.2rem', borderRadius: '6px', background: 'rgba(255,255,255,0.04)', border: '1px solid rgba(255,255,255,0.08)', color: '#a5b4fc', fontSize: '0.85rem', fontFamily: 'ui-monospace, monospace' }}>
           Edit app/modules/main/pages/index.tsx
         </code>
+        <p style={{ fontSize: '0.85rem', color: '#94a3b8', margin: '0.5rem 0 0' }}>
+          <a href="/about" style={{ color: '#818cf8', textDecoration: 'none' }}>About</a>
+          {' '}is the about module — app/modules/about/pages/index.tsx → /about
+        </p>
       </div>
 
       <footer style={{ position: 'relative', zIndex: 1, marginTop: '4rem', paddingTop: '2rem', borderTop: '1px solid rgba(255,255,255,0.06)', width: '100%', maxWidth: '640px' }}>
@@ -1818,6 +1911,28 @@ export default async function HomePage() {
 }
 `;
 }
+function generateAboutPage() {
+  return `export const metadata = {
+  title: 'About',
+  description: 'The about module maps to the /about route.',
+};
+
+export default function AboutPage() {
+  return (
+    <div style={{ minHeight: '100vh', display: 'flex', flexDirection: 'column', alignItems: 'center', justifyContent: 'center', background: 'linear-gradient(145deg, #0a0a12 0%, #0d1117 40%, #111827 100%)', color: '#e2e8f0', fontFamily: 'system-ui, -apple-system, sans-serif', padding: '2rem', textAlign: 'center' }}>
+      <p style={{ fontSize: '0.8rem', letterSpacing: '0.15em', textTransform: 'uppercase', color: '#818cf8', marginBottom: '1.5rem', fontWeight: 500 }}>Module route</p>
+      <h1 style={{ fontSize: 'clamp(2rem, 5vw, 3rem)', fontWeight: 700, lineHeight: 1.1, margin: '0 0 1.5rem' }}>About</h1>
+      <p style={{ fontSize: '1.05rem', lineHeight: 1.7, color: '#94a3b8', marginBottom: '2rem', maxWidth: '480px' }}>
+        This page is <code style={{ color: '#a5b4fc' }}>app/modules/about/pages/index.tsx</code>.
+        A module name is a URL prefix, so the about module is <code style={{ color: '#a5b4fc' }}>/about</code>.
+        The main module is the site root.
+      </p>
+      <a href="/" style={{ color: '#818cf8', textDecoration: 'none', fontWeight: 500 }}>Home</a>
+    </div>
+  );
+}
+`;
+}
 function generate404Page() {
   return `export const metadata = {
   title: '404 - Page Not Found',
@@ -1844,7 +1959,8 @@ function generatePostBuildMjs() {
     ` * Post-build script — delegates to Avalon's built-in post-build.`,
     ` *`,
     ` * All the heavy lifting (CSS patching, island redirects, prerendering,`,
-    ` * Netlify function copying) is handled by the framework.`,
+    ` * Cloudflare worker patches, Netlify function copying) is handled by`,
+    ` * the framework.`,
     ` */`,
     `import { runPostBuild } from '@useavalon/avalon/post-build';`,
     ``,
@@ -1864,6 +1980,7 @@ function generatePostBuildMjs() {
 function generateStylingFiles(config) {
   const files = new Map;
   files.set("app/shared/styles/main.css", generateMainCss(config));
+  files.set("public/syntax-highlighting.css", generateSyntaxHighlightingCss());
   if (config.styling === "css-modules") {
     files.set("app/shared/styles/reset.css", generateResetCss());
   }
@@ -2057,6 +2174,30 @@ function generateShadcnComponentsJson(config) {
   return JSON.stringify(componentsConfig, null, 2) + `
 `;
 }
+function generateSyntaxHighlightingCss() {
+  return `code.hljs { padding: 3px 5px; }
+pre code.hljs { display: block; overflow-x: auto; padding: 1em; }
+.hljs { color: #c9d1d9; background: transparent; }
+.hljs-doctag, .hljs-keyword, .hljs-meta .hljs-keyword, .hljs-template-tag,
+.hljs-template-variable, .hljs-type, .hljs-variable.language_ { color: #ff7b72; }
+.hljs-title, .hljs-title.class_, .hljs-title.class_.inherited__,
+.hljs-title.function_ { color: #d2a8ff; }
+.hljs-attr, .hljs-attribute, .hljs-literal, .hljs-meta, .hljs-number,
+.hljs-operator, .hljs-variable, .hljs-selector-attr, .hljs-selector-class,
+.hljs-selector-id { color: #79c0ff; }
+.hljs-regexp, .hljs-string, .hljs-meta .hljs-string { color: #a5d6ff; }
+.hljs-built_in, .hljs-symbol { color: #ffa657; }
+.hljs-comment, .hljs-code, .hljs-formula { color: #8b949e; }
+.hljs-name, .hljs-quote, .hljs-selector-tag, .hljs-selector-pseudo { color: #7ee787; }
+.hljs-subst { color: #c9d1d9; }
+.hljs-section { color: #1f6feb; font-weight: bold; }
+.hljs-bullet { color: #f2cc60; }
+.hljs-emphasis { color: #c9d1d9; font-style: italic; }
+.hljs-strong { color: #c9d1d9; font-weight: bold; }
+.hljs-addition { color: #aff5b4; background-color: #033a16; }
+.hljs-deletion { color: #ffdcd7; background-color: #67060c; }
+`;
+}
 
 // src/templates/tsconfig.ts
 function generateTsConfig(core = "preact") {
@@ -2180,6 +2321,7 @@ function generateViteConfig(config) {
     `        { schedule: '${EXAMPLE_CRON_SCHEDULE}', handler: '${EXAMPLE_CRON_HANDLER}' },`,
     `      ],`
   ] : [];
+  const compatLines = config.deploy === "cloudflare" ? [`      compatibilityDate: '2026-09-04',`] : [];
   const lines = [
     imports.join(`
 `),
@@ -2194,10 +2336,11 @@ function generateViteConfig(config) {
     `    nitro: {`,
     `      preset: process.env.NITRO_PRESET || 'node_server',`,
     `      streaming: true,`,
+    ...compatLines,
     `      clientEntry: 'app/entry-client',`,
     `      globalCSS: ['app/shared/styles/main.css'],`,
     `      prerender: {`,
-    `        routes: ['/'],`,
+    `        routes: ['/', '/about'],`,
     `        crawlLinks: true,`,
     `        ignore: [],`,
     `      },`,
@@ -2298,6 +2441,8 @@ async function scaffoldProject(config, targetDir) {
   await writeFile(join(targetDir, "app/modules/main/layouts/_layout.tsx"), generateMainLayout(config));
   await writeFile(join(targetDir, "app/modules/main/pages/index.tsx"), generateMainPage(config));
   await writeFile(join(targetDir, "app/modules/main/pages/404.tsx"), generate404Page());
+  await writeFile(join(targetDir, "app/modules/about/layouts/_layout.tsx"), generateAboutLayout(config));
+  await writeFile(join(targetDir, "app/modules/about/pages/index.tsx"), generateAboutPage());
   await writeFile(join(targetDir, "middleware/01.logger.ts"), generateSampleMiddleware(config));
   await writeFile(join(targetDir, "routes/api/hello.ts"), generateHelloRoute(config));
   if (config.cron) {
@@ -2324,13 +2469,10 @@ async function scaffoldProject(config, targetDir) {
 `);
   await writeFile(join(targetDir, "server/renderer.ts"), [
     `/**`,
-    ` * SSR Renderer — provided by Avalon's virtual module system.`,
-    ` *`,
-    ` * Avalon auto-discovers layouts, injects client assets, and handles`,
-    ` * layout wrapping. Import from the virtual modules directly to customize:`,
+    ` * Nitro SSR catch-all. Keep this re-export for the default renderer.`,
     ` *`,
-    ` *   import { wrapWithLayouts } from 'virtual:avalon/layouts';`,
-    ` *   import { injectAssets } from 'virtual:avalon/assets';`,
+    ` * Customize only when you need a custom hydration directive or to wrap`,
+    ` * the handler. See https://useavalon.dev/docs/ssr-renderer`,
     ` */`,
     `export { default } from 'virtual:avalon/renderer';`,
     ``
@@ -2338,9 +2480,15 @@ async function scaffoldProject(config, targetDir) {
 `));
   await writeFile(join(targetDir, "build.mjs"), generateBuildMjs());
   await writeFile(join(targetDir, "post-build.mjs"), generatePostBuildMjs());
+  await writeFile(join(targetDir, ".gitignore"), generateGitignore(config));
+  await writeFile(join(targetDir, "DEPLOY.md"), generateDeployReadme(config));
   if (config.deploy === "netlify") {
     await writeFile(join(targetDir, "netlify.toml"), generateNetlifyToml(config));
   }
+  if (config.deploy === "cloudflare") {
+    await writeFile(join(targetDir, "wrangler.toml"), generateWranglerToml(config));
+    await writeFile(join(targetDir, "public/_headers"), generateCloudflareHeaders());
+  }
 }
 
 // src/summary.ts
@@ -2350,15 +2498,34 @@ var STYLING_LABELS = {
   shadcn: "shadcn"
 };
 var DEPLOY_LABELS = {
+  cloudflare: "Cloudflare Pages",
   netlify: "Netlify",
   none: "None"
 };
+function deployNextSteps(config) {
+  if (config.deploy === "cloudflare") {
+    return [
+      "    bun run build",
+      "    bun run preview   # wrangler pages dev",
+      "    # See DEPLOY.md for Cloudflare Pages deploy steps"
+    ];
+  }
+  if (config.deploy === "netlify") {
+    return ["    bun run build", "    # Connect the repo in Netlify, or see DEPLOY.md"];
+  }
+  return ["    bun run build"];
+}
 function formatSummary(config, scaffoldedInPlace = false) {
   const integrations = config.integrations.length > 0 ? config.integrations.join(", ") : "none";
   const styling = STYLING_LABELS[config.styling] ?? config.styling;
   const plugins = config.plugins.length > 0 ? config.plugins.join(", ") : "none";
   const deploy = DEPLOY_LABELS[config.deploy] ?? config.deploy;
-  const nextSteps = scaffoldedInPlace ? ["    bun install", "    bun run dev"] : [`    cd ${config.projectName}`, "    bun install", "    bun run dev"];
+  const nextSteps = scaffoldedInPlace ? ["    bun install", "    bun run dev", ...deployNextSteps(config)] : [
+    `    cd ${config.projectName}`,
+    "    bun install",
+    "    bun run dev",
+    ...deployNextSteps(config)
+  ];
   return [
     "",
     `  Project:        ${config.projectName}`,
@@ -2366,7 +2533,7 @@ function formatSummary(config, scaffoldedInPlace = false) {
     `  Styling:        ${styling}`,
     `  Plugins:        ${plugins}`,
     `  Middleware:     ${config.middleware}`,
-    `  Deploy:        ${deploy}`,
+    `  Deploy:         ${deploy}`,
     `  Cron:           ${config.cron ? "yes" : "no"}`,
     "",
     "  Next steps:",
@@ -2402,9 +2569,9 @@ async function main() {
       "      --core           Rendering engine: preact (default) | react",
       "      --integrations   Comma list: preact,react,vue,svelte,solid,lit,qwik",
       "      --styling        css-modules (default) | tailwind | shadcn",
-      "      --plugins        Comma list: seo (default),agent-optimization,syntax-highlighting",
+      "      --plugins        Comma list: seo (default),agent-optimization",
       "      --middleware     h3 (default) | hono | elysia",
-      "      --deploy         netlify | none (default)",
+      "      --deploy         cloudflare | netlify | none (default)",
       "      --cron           Scaffold an example cron task + config",
       "",
       "Example:",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "create-avalon",
-	"version": "0.1.25",
+	"version": "0.2.1",
 	"description": "Scaffold a new Avalon project with multi-framework islands architecture",
 	"license": "MIT",
 	"type": "module",