create-avalon 0.1.24 → 0.2.0

package/README.md

@@ -19,10 +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)
-- Package manager preference
+- Rendering engine (Preact or React) and island integrations
+- Styling approach (CSS Modules, Tailwind, shadcn)
+- Plugins (SEO, agent optimization, syntax highlighting)
+- 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
 
@@ -32,7 +44,7 @@ A ready-to-run Avalon project with file-system routing, islands architecture, an
 my-project/
 ├── app/
 │   ├── modules/
-│   │   └── home/
+│   │   └── main/
 │   │       ├── pages/          # File-system routes
 │   │       ├── components/     # Interactive components
 │   │       └── layouts/        # Module layouts
@@ -43,8 +55,14 @@ my-project/
 ├── middleware/                  # Server middleware
 ├── routes/
 │   └── 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";
@@ -76,12 +92,69 @@ var require_src = __commonJS((exports, module) => {
 });
 
 // src/cli.ts
-import { basename, resolve } from "node:path";
 import { createRequire } from "node:module";
+import { basename, resolve } from "node:path";
 
 // src/cli-utils.ts
-import { parseArgs } from "node:util";
 import { existsSync, readdirSync } from "node:fs";
+import { parseArgs } from "node:util";
+
+// src/types.ts
+var RENDER_ENGINES = ["preact", "react"];
+var INTEGRATIONS = [
+  "preact",
+  "react",
+  "vue",
+  "svelte",
+  "solid",
+  "lit",
+  "qwik"
+];
+var STYLING_OPTIONS = [
+  "css-modules",
+  "tailwind",
+  "shadcn"
+];
+var PLUGINS = [
+  "seo",
+  "agent-optimization",
+  "syntax-highlighting"
+];
+var MIDDLEWARE_OPTIONS = [
+  "h3",
+  "hono",
+  "elysia"
+];
+var DEPLOY_TARGETS = [
+  "cloudflare",
+  "netlify",
+  "none"
+];
+var INTEGRATION_PACKAGES = {
+  preact: "@useavalon/preact",
+  react: "@useavalon/react",
+  vue: "@useavalon/vue",
+  svelte: "@useavalon/svelte",
+  solid: "@useavalon/solid",
+  lit: "@useavalon/lit",
+  qwik: "@useavalon/qwik"
+};
+var BASE_DIRS = [
+  "app/modules/main/pages",
+  "app/modules/main/components",
+  "app/modules/main/layouts",
+  "app/shared/layouts",
+  "app/shared/components",
+  "app/shared/styles",
+  "middleware",
+  "routes/api",
+  "public",
+  "server"
+];
+
+// src/cli-utils.ts
+class CliArgError extends Error {
+}
 function validateDirectory(dir) {
   if (!existsSync(dir)) {
     return { valid: true };
@@ -100,7 +173,15 @@ function parseCliArgs(argv) {
     args: argv,
     options: {
       help: { type: "boolean", default: false, short: "h" },
-      version: { type: "boolean", default: false, short: "v" }
+      version: { type: "boolean", default: false, short: "v" },
+      yes: { type: "boolean", default: false, short: "y" },
+      core: { type: "string" },
+      integrations: { type: "string" },
+      styling: { type: "string" },
+      plugins: { type: "string" },
+      middleware: { type: "string" },
+      deploy: { type: "string" },
+      cron: { type: "boolean", default: false }
     },
     strict: true,
     allowPositionals: true
@@ -108,7 +189,58 @@ function parseCliArgs(argv) {
   return {
     projectName: positionals[0] ?? undefined,
     help: values.help ?? false,
-    version: values.version ?? false
+    version: values.version ?? false,
+    yes: values.yes ?? false,
+    core: values.core,
+    integrations: values.integrations,
+    styling: values.styling,
+    plugins: values.plugins,
+    middleware: values.middleware,
+    deploy: values.deploy,
+    cron: values.cron ?? false
+  };
+}
+var csv = (value) => value ? value.split(",").map((v) => v.trim()).filter(Boolean) : undefined;
+function assertOneOf(value, allowed, flag) {
+  if (value === undefined)
+    return;
+  if (!allowed.includes(value)) {
+    throw new CliArgError(`Invalid value "${value}" for --${flag}. Allowed: ${allowed.join(", ")}.`);
+  }
+  return value;
+}
+function assertAllOf(values, allowed, flag) {
+  if (values === undefined)
+    return;
+  for (const value of values) {
+    if (!allowed.includes(value)) {
+      throw new CliArgError(`Invalid value "${value}" for --${flag}. Allowed: ${allowed.join(", ")}.`);
+    }
+  }
+  return values;
+}
+function resolveConfigNonInteractive(args) {
+  const core = assertOneOf(args.core, RENDER_ENGINES, "core") ?? "preact";
+  const integrations = assertAllOf(csv(args.integrations), INTEGRATIONS, "integrations") ?? [];
+  const styling = assertOneOf(args.styling, STYLING_OPTIONS, "styling") ?? "css-modules";
+  const plugins = assertAllOf(csv(args.plugins), PLUGINS, "plugins") ?? ["seo"];
+  const middleware = assertOneOf(args.middleware, MIDDLEWARE_OPTIONS, "middleware") ?? "h3";
+  const deploy = assertOneOf(args.deploy, DEPLOY_TARGETS, "deploy") ?? "none";
+  if (styling === "shadcn" && core !== "react") {
+    throw new CliArgError("--styling=shadcn requires --core=react (shadcn is Radix/React based).");
+  }
+  if (!integrations.includes(core)) {
+    integrations.push(core);
+  }
+  return {
+    projectName: args.projectName ?? ".",
+    core,
+    integrations,
+    styling,
+    plugins,
+    middleware,
+    deploy,
+    cron: args.cron
   };
 }
 
@@ -468,125 +600,20 @@ 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;
+class kt extends B {
   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("")}`;
+    return this.value ? 0 : 1;
   }
-  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 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];
-    }
+  get _value() {
+    return this.cursor === 0;
   }
   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;
-      }
+    super(e, false), this.value = !!e.initialValue, this.on("userInput", () => {
+      this.value = this._value;
+    }), this.on("confirm", (s) => {
+      this.output.write(import_sisteransi.cursor.move(0, -1)), this.value = s, this.state = "submit", this.close();
+    }), this.on("cursor", () => {
+      this.value = !this.value;
     });
   }
 }
@@ -758,59 +785,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;
@@ -818,7 +845,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;
@@ -827,9 +854,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)
@@ -863,7 +890,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); )
@@ -880,8 +907,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) {
@@ -897,7 +924,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;
@@ -905,12 +932,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 === `
@@ -943,16 +970,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);
@@ -961,6 +988,33 @@ var X2 = ({ cursor: e, options: r, style: s, output: i = process.stdout, maxItem
       C.push(b);
   return $ && C.push(c), C;
 };
+var Rt = (e) => {
+  const r = e.active ?? "Yes", s = e.inactive ?? "No";
+  return new kt({ active: r, inactive: s, signal: e.signal, input: e.input, output: e.output, initialValue: e.initialValue ?? true, render() {
+    const i = e.withGuide ?? _.withGuide, a = `${i ? `${t("gray", h)}
+` : ""}${W2(this.state)}  ${e.message}
+`, o = this.value ? r : s;
+    switch (this.state) {
+      case "submit": {
+        const u = i ? `${t("gray", h)}  ` : "";
+        return `${a}${u}${t("dim", o)}`;
+      }
+      case "cancel": {
+        const u = i ? `${t("gray", h)}  ` : "";
+        return `${a}${u}${t(["strikethrough", "dim"], o)}${i ? `
+${t("gray", h)}` : ""}`;
+      }
+      default: {
+        const u = i ? `${t("cyan", h)}  ` : "", l = i ? t("cyan", x2) : "";
+        return `${a}${u}${this.value ? `${t("green", z2)} ${r}` : `${t("dim", H2)} ${t("dim", r)}`}${e.vertical ? i ? `
+${t("cyan", h)}  ` : `
+` : ` ${t("dim", "/")} `}${this.value ? `${t("dim", H2)} ${t("dim", s)}` : `${t("green", z2)} ${s}`}
+${l}
+`;
+      }
+    }
+  } }).prompt();
+};
 var Nt = (e = "", r) => {
   const s = r?.output ?? process.stdout, i = r?.withGuide ?? _.withGuide ? `${t("gray", x2)}  ` : "";
   s.write(`${i}${t("red", e)}
@@ -1124,6 +1178,26 @@ async function collectProjectConfig(initialName) {
     }
     projectName = nameResult;
   }
+  const coreResult = await Jt({
+    message: "Which rendering engine should render your pages (the shell)?",
+    options: [
+      {
+        value: "preact",
+        label: "Preact",
+        hint: "Smallest runtime (default). React libs run via preact/compat."
+      },
+      {
+        value: "react",
+        label: "React",
+        hint: "Real react-dom/server. React libs like Radix/shadcn work natively."
+      }
+    ],
+    initialValue: "preact"
+  });
+  if (Ct(coreResult)) {
+    Nt("Operation cancelled.");
+    process.exit(1);
+  }
   const integrationsResult = await Lt2({
     message: "Which integrations would you like to include? (use space to toggle, enter to confirm)",
     options: [
@@ -1141,13 +1215,20 @@ async function collectProjectConfig(initialName) {
     Nt("Operation cancelled.");
     process.exit(1);
   }
+  const stylingOptions = [
+    { value: "css-modules", label: "CSS Modules" },
+    { value: "tailwind", label: "Tailwind CSS" }
+  ];
+  if (coreResult === "react") {
+    stylingOptions.push({
+      value: "shadcn",
+      label: "shadcn",
+      hint: "Radix-based components — requires the React engine"
+    });
+  }
   const stylingResult = await Jt({
     message: "Which styling approach would you like to use?",
-    options: [
-      { value: "css-modules", label: "CSS Modules" },
-      { value: "tailwind", label: "Tailwind CSS" },
-      { value: "shadcn", label: "shadcn" }
-    ]
+    options: stylingOptions
   });
   if (Ct(stylingResult)) {
     Nt("Operation cancelled.");
@@ -1156,8 +1237,16 @@ async function collectProjectConfig(initialName) {
   const pluginsResult = await Lt2({
     message: "Which plugins would you like to include? (use space to toggle, enter to confirm)",
     options: [
-      { value: "seo", label: "seo", hint: "Auto-injects OG, Twitter cards, JSON-LD, canonical URLs" },
-      { value: "agent-optimization", label: "agent-optimization", hint: "LLM/AI optimization (llms.txt, markdown, sitemap)" },
+      {
+        value: "seo",
+        label: "seo",
+        hint: "Auto-injects OG, Twitter cards, JSON-LD, canonical URLs"
+      },
+      {
+        value: "agent-optimization",
+        label: "agent-optimization",
+        hint: "LLM/AI optimization (llms.txt, markdown, sitemap)"
+      },
       {
         value: "syntax-highlighting",
         label: "syntax-highlighting",
@@ -1186,21 +1275,45 @@ async function collectProjectConfig(initialName) {
   const deployResult = await Jt({
     message: "Where will you deploy?",
     options: [
-      { value: "netlify", label: "Netlify", hint: "Generates netlify.toml, build.mjs, post-build.mjs" },
-      { value: "none", label: "None / Other", hint: "Node server preset, no deploy config" }
+      {
+        value: "cloudflare",
+        label: "Cloudflare Pages",
+        hint: "wrangler.toml, public/_headers, build + deploy scripts"
+      },
+      {
+        value: "netlify",
+        label: "Netlify",
+        hint: "netlify.toml, build.mjs, post-build.mjs"
+      },
+      { value: "none", label: "None / Other", hint: "Node server preset, no platform config" }
     ]
   });
   if (Ct(deployResult)) {
     Nt("Operation cancelled.");
     process.exit(1);
   }
+  const cronResult = await Rt({
+    message: "Set up scheduled jobs (cron)?",
+    initialValue: false
+  });
+  if (Ct(cronResult)) {
+    Nt("Operation cancelled.");
+    process.exit(1);
+  }
+  const core = coreResult;
+  const integrations = integrationsResult;
+  if (!integrations.includes(core)) {
+    integrations.push(core);
+  }
   return {
     projectName,
-    integrations: integrationsResult,
+    core,
+    integrations,
     styling: stylingResult,
     plugins: pluginsResult,
     middleware: middlewareResult,
-    deploy: deployResult
+    deploy: deployResult,
+    cron: cronResult
   };
 }
 
@@ -1218,7 +1331,36 @@ export default defineHandler(() => {
 `;
 }
 
+// src/templates/cron.ts
+var EXAMPLE_CRON_HANDLER = "tasks/cleanup.ts";
+var EXAMPLE_CRON_SCHEDULE = "0 * * * *";
+function generateExampleCronTask(_config) {
+  return `import { defineCronJob } from '@useavalon/avalon/cron';
+
+/**
+ * Example scheduled job. Runs on the schedule defined in vite.config.ts
+ * (\`nitro.cron\`). The task name is derived from this file path: "cleanup".
+ *
+ * In production this runs via your deployment preset's scheduler
+ * (Vercel Cron, Cloudflare Triggers, or the Node server's in-process
+ * scheduler). In development Avalon runs it inside the Vite dev server.
+ */
+export default defineCronJob({
+  meta: { description: 'Example scheduled job' },
+  async run() {
+    console.log('[cron] cleanup ran at', new Date().toISOString());
+    // TODO: replace with your scheduled work.
+    return { result: 'ok' };
+  },
+});
+`;
+}
+
 // 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 = "."
@@ -1243,6 +1385,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.
@@ -1250,20 +1503,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 });
@@ -1275,10 +1557,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 {}
@@ -1290,29 +1575,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();
 });
 
@@ -1322,10 +1618,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);
   }
@@ -1333,6 +1633,7 @@ const poll = setInterval(() => {
 
 const absoluteTimeout = setTimeout(() => {
   console.error('[build] Timeout — killing build');
+  killedEarly = true;
   finish();
 }, 240_000);
 `;
@@ -1393,6 +1694,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=";
@@ -1453,36 +1770,30 @@ export default defineHandler((event) => {
 `;
 }
 
-// src/types.ts
-var INTEGRATION_PACKAGES = {
-  preact: "@useavalon/preact",
-  react: "@useavalon/react",
-  vue: "@useavalon/vue",
-  svelte: "@useavalon/svelte",
-  solid: "@useavalon/solid",
-  lit: "@useavalon/lit",
-  qwik: "@useavalon/qwik"
-};
-var BASE_DIRS = [
-  "app/modules/main/pages",
-  "app/modules/main/components",
-  "app/modules/main/layouts",
-  "app/shared/layouts",
-  "app/shared/components",
-  "app/shared/styles",
-  "middleware",
-  "routes/api",
-  "public",
-  "server"
-];
-
 // src/templates/package-json.ts
+var INTEGRATION_RUNTIME_DEPS = {
+  preact: { preact: "^10.0.0", "preact-render-to-string": "^6.0.0" },
+  react: { react: "^19.0.0", "react-dom": "^19.0.0" },
+  vue: { vue: "^3.4.0" },
+  svelte: { svelte: "^5.0.0" },
+  solid: { "solid-js": "^1.8.0" },
+  lit: {
+    lit: "^3.0.0",
+    "@lit-labs/ssr": "^4.0.0",
+    "@lit-labs/ssr-client": "^1.0.0",
+    "@lit-labs/ssr-dom-shim": "^1.0.0"
+  },
+  qwik: { "@builder.io/qwik": "^1.5.0" }
+};
 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]);
   }
   if (config.plugins.includes("seo")) {
     dependencies["@useavalon/seo"] = "latest";
@@ -1490,9 +1801,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";
@@ -1502,10 +1811,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":
@@ -1520,15 +1829,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
   };
@@ -1615,7 +1930,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';`,
     ``,
@@ -1830,7 +2146,7 @@ function generateShadcnComponentsJson(config) {
 }
 
 // src/templates/tsconfig.ts
-function generateTsConfig() {
+function generateTsConfig(core = "preact") {
   const tsconfig = {
     compilerOptions: {
       target: "ESNext",
@@ -1843,6 +2159,7 @@ function generateTsConfig() {
       allowImportingTsExtensions: true,
       noEmit: true,
       jsx: "react-jsx",
+      jsxImportSource: core,
       paths: {
         "@shared/*": ["./app/shared/*"],
         "@modules/*": ["./app/modules/*"]
@@ -1943,12 +2260,21 @@ function generateViteConfig(config) {
   if (needsTailwind) {
     pluginEntries.push(`    tailwindcss(),`);
   }
+  const cronLines = config.cron ? [
+    `      // Scheduled jobs (cron). Each entry maps a schedule to a task file`,
+    `      // in tasks/. See https://useavalon.dev/docs/cron-jobs`,
+    `      cron: [`,
+    `        { schedule: '${EXAMPLE_CRON_SCHEDULE}', handler: '${EXAMPLE_CRON_HANDLER}' },`,
+    `      ],`
+  ] : [];
+  const compatLines = config.deploy === "cloudflare" ? [`      compatibilityDate: '2026-09-04',`] : [];
   const lines = [
     imports.join(`
 `),
     "",
     `export default defineConfig(async (): Promise<UserConfig> => {`,
     `  const avalonPlugins = await avalon({`,
+    `    core: '${config.core}',`,
     `    integrations: [${integrationsList}],`,
     `    modules: 'app/modules',`,
     `    layoutsDir: 'app/shared/layouts',`,
@@ -1956,6 +2282,7 @@ 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: {`,
@@ -1963,6 +2290,7 @@ function generateViteConfig(config) {
     `        crawlLinks: true,`,
     `        ignore: [],`,
     `      },`,
+    ...cronLines,
     `    },`,
     `  });`,
     "",
@@ -2053,7 +2381,7 @@ async function scaffoldProject(config, targetDir) {
     await mkdir(join(targetDir, dir), { recursive: true });
   }
   await writeFile(join(targetDir, "package.json"), generatePackageJson(config));
-  await writeFile(join(targetDir, "tsconfig.json"), generateTsConfig());
+  await writeFile(join(targetDir, "tsconfig.json"), generateTsConfig(config.core));
   await writeFile(join(targetDir, "vite.config.ts"), generateViteConfig(config));
   await writeFile(join(targetDir, "app/shared/layouts/_layout.tsx"), generateRootLayout(config));
   await writeFile(join(targetDir, "app/modules/main/layouts/_layout.tsx"), generateMainLayout(config));
@@ -2061,6 +2389,11 @@ async function scaffoldProject(config, targetDir) {
   await writeFile(join(targetDir, "app/modules/main/pages/404.tsx"), generate404Page());
   await writeFile(join(targetDir, "middleware/01.logger.ts"), generateSampleMiddleware(config));
   await writeFile(join(targetDir, "routes/api/hello.ts"), generateHelloRoute(config));
+  if (config.cron) {
+    const cronPath = join(targetDir, EXAMPLE_CRON_HANDLER);
+    await mkdir(dirname(cronPath), { recursive: true });
+    await writeFile(cronPath, generateExampleCronTask(config));
+  }
   if (config.middleware === "hono") {
     await writeFile(join(targetDir, "server.ts"), generateHonoServerEntry());
   } else if (config.middleware === "elysia") {
@@ -2076,6 +2409,8 @@ async function scaffoldProject(config, targetDir) {
   await writeFile(join(targetDir, "server/env.d.ts"), `/// <reference types="nitro" />
 `);
   await writeFile(join(targetDir, "app/env.d.ts"), generateEnvDts(config.integrations));
+  await writeFile(join(targetDir, "app/entry-client.ts"), `import "virtual:avalon/client-entry";
+`);
   await writeFile(join(targetDir, "server/renderer.ts"), [
     `/**`,
     ` * SSR Renderer — provided by Avalon's virtual module system.`,
@@ -2092,9 +2427,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
@@ -2104,15 +2445,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}`,
@@ -2120,7 +2480,8 @@ function formatSummary(config, scaffoldedInPlace = false) {
     `  Styling:        ${styling}`,
     `  Plugins:        ${plugins}`,
     `  Middleware:     ${config.middleware}`,
-    `  Deploy:        ${deploy}`,
+    `  Deploy:         ${deploy}`,
+    `  Cron:           ${config.cron ? "yes" : "no"}`,
     "",
     "  Next steps:",
     ...nextSteps,
@@ -2142,11 +2503,28 @@ async function main() {
     process.exit(0);
   }
   if (args.help) {
-    console.log(`Usage: create-avalon [project-name]
-
-Options:
-  -v, --version  Show version number
-  -h, --help     Show help`);
+    console.log([
+      "Usage: create-avalon [project-name] [options]",
+      "",
+      "Runs interactively by default. Pass --yes (or run without a TTY, e.g. in",
+      "CI/Docker) to scaffold non-interactively from flags + defaults.",
+      "",
+      "Options:",
+      "  -v, --version        Show version number",
+      "  -h, --help           Show help",
+      "  -y, --yes            Skip prompts; use flags and defaults",
+      "      --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",
+      "      --middleware     h3 (default) | hono | elysia",
+      "      --deploy         cloudflare | netlify | none (default)",
+      "      --cron           Scaffold an example cron task + config",
+      "",
+      "Example:",
+      "  create-avalon my-app --yes --core react --integrations react,vue --styling shadcn"
+    ].join(`
+`));
     process.exit(0);
   }
   if (args.projectName && args.projectName !== ".") {
@@ -2156,7 +2534,8 @@ Options:
       process.exit(1);
     }
   }
-  const config = await collectProjectConfig(args.projectName);
+  const nonInteractive = args.yes || !process.stdin.isTTY;
+  const config = nonInteractive ? resolveConfigNonInteractive(args) : await collectProjectConfig(args.projectName);
   if (!args.projectName && config.projectName !== ".") {
     const dirResult = validateDirectory(resolve(config.projectName));
     if (!dirResult.valid) {
@@ -2173,4 +2552,9 @@ Options:
   printSummary(config, scaffoldedInPlace);
   process.exit(0);
 }
-main();
+try {
+  await main();
+} catch (error) {
+  console.error(error instanceof CliArgError ? error.message : error);
+  process.exit(1);
+}

package/package.json

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