create-avalon 0.1.23 → 0.1.25

package/README.md

@@ -22,6 +22,7 @@ The CLI walks you through:
 - 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
 
 ## What you get
@@ -43,6 +44,7 @@ my-project/
 ├── middleware/                  # Server middleware
 ├── routes/
 │   └── api/                    # API routes
+├── tasks/                      # Scheduled jobs (cron) — optional
 ├── server/                     # Server config & env
 ├── public/                     # Static assets
 ├── vite.config.ts

package/dist/cli.js

@@ -76,12 +76,65 @@ 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 = ["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 +153,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 +169,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 (core === "react" && !integrations.includes("react")) {
+    integrations.push("react");
+  }
+  return {
+    projectName: args.projectName ?? ".",
+    core,
+    integrations,
+    styling,
+    plugins,
+    middleware,
+    deploy,
+    cron: args.cron
   };
 }
 
@@ -543,6 +655,25 @@ class Vt extends B {
     }
   }
 }
+
+class kt extends B {
+  get cursor() {
+    return this.value ? 0 : 1;
+  }
+  get _value() {
+    return this.cursor === 0;
+  }
+  constructor(e) {
+    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;
+    });
+  }
+}
+
 class yt extends B {
   options;
   cursor = 0;
@@ -961,6 +1092,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 +1282,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 +1319,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,13 +1341,23 @@ 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: "agent-optimization", label: "agent-optimization", hint: "LLM/AI optimization" },
+      {
+        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",
         hint: "Code block highlighting for MDX (rehype-highlight)"
       }
     ],
+    initialValues: ["seo"],
     required: false
   });
   if (Ct(pluginsResult)) {
@@ -1184,7 +1379,11 @@ 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: "netlify",
+        label: "Netlify",
+        hint: "Generates netlify.toml, build.mjs, post-build.mjs"
+      },
       { value: "none", label: "None / Other", hint: "Node server preset, no deploy config" }
     ]
   });
@@ -1192,13 +1391,28 @@ async function collectProjectConfig(initialName) {
     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 (core === "react" && !integrations.includes("react")) {
+    integrations.push("react");
+  }
   return {
     projectName,
-    integrations: integrationsResult,
+    core,
+    integrations,
     styling: stylingResult,
     plugins: pluginsResult,
     middleware: middlewareResult,
-    deploy: deployResult
+    deploy: deployResult,
+    cron: cronResult
   };
 }
 
@@ -1216,6 +1430,31 @@ 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 generateNetlifyToml(_config) {
   return `[build]
@@ -1335,6 +1574,62 @@ const absoluteTimeout = setTimeout(() => {
 }, 240_000);
 `;
 }
+function generateRobotsTxt(sitemapUrl = "https://YOUR_DOMAIN/sitemap.xml") {
+  return `# robots.txt
+
+User-agent: *
+Allow: /
+
+# Sitemap
+Sitemap: ${sitemapUrl}
+
+# AI Crawlers — explicitly allowed
+User-agent: GPTBot
+Allow: /
+
+User-agent: ChatGPT-User
+Allow: /
+
+User-agent: Google-Extended
+Allow: /
+
+User-agent: PerplexityBot
+Allow: /
+
+User-agent: OAI-SearchBot
+Allow: /
+
+User-agent: Applebot-Extended
+Allow: /
+
+User-agent: Amazonbot
+Allow: /
+
+User-agent: ClaudeBot
+Allow: /
+
+User-agent: Bytespider
+Allow: /
+
+User-agent: cohere-ai
+Allow: /
+
+User-agent: Diffbot
+Allow: /
+
+User-agent: anthropic-ai
+Allow: /
+
+User-agent: Claude-Web
+Allow: /
+
+User-agent: CCBot
+Allow: /
+
+User-agent: AI2Bot
+Allow: /
+`;
+}
 
 // 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=";
@@ -1351,16 +1646,21 @@ function generateRootLayout(config) {
   } else {
     imports.push(`import '../styles/main.css';`);
   }
+  const safeName = config.projectName.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/`/g, "\\`").replace(/\$\{/g, "\\${");
   return `${imports.join(`
 `)}
 
-export default async function RootLayout({ children }: Readonly<LayoutProps>) {
+export default async function RootLayout({ children, frontmatter }: Readonly<LayoutProps>) {
+  const title = frontmatter?.title ?? '${safeName}';
+  const description = frontmatter?.description ?? '';
+
   return (
     <html lang="en">
       <head>
         <meta charset="UTF-8" />
         <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-        <title>${config.projectName}</title>
+        <title>{title}</title>
+        {description && <meta name="description" content={description} />}
         <link rel="icon" href="/favicon.ico" />
       </head>
       <body style={{ margin: 0 }}>
@@ -1371,10 +1671,10 @@ export default async function RootLayout({ children }: Readonly<LayoutProps>) {
 }
 `;
 }
-function generateHomeLayout(config) {
+function generateMainLayout(config) {
   return `import type { LayoutProps } from '@useavalon/avalon';
 
-export default async function HomeLayout({ children }: Readonly<LayoutProps>) {
+export default async function MainLayout({ children }: Readonly<LayoutProps>) {
   return <>{children}</>;
 }
 `;
@@ -1390,36 +1690,31 @@ 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/home/pages",
-  "app/modules/home/components",
-  "app/modules/home/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) {
     dependencies[INTEGRATION_PACKAGES[integration]] = "latest";
+    Object.assign(dependencies, INTEGRATION_RUNTIME_DEPS[integration]);
+  }
+  if (config.plugins.includes("seo")) {
+    dependencies["@useavalon/seo"] = "latest";
   }
   if (config.plugins.includes("agent-optimization")) {
     dependencies["@useavalon/agent-optimization"] = "latest";
@@ -1470,7 +1765,7 @@ function generatePackageJson(config) {
 }
 
 // src/templates/pages.ts
-function generateHomePage(config) {
+function generateMainPage(config) {
   return `export const metadata = {
   title: 'Avalon — Islands Architecture',
   description: 'A multi-framework islands architecture project powered by Avalon.',
@@ -1508,7 +1803,7 @@ export default async function HomePage() {
       <div style={{ position: 'relative', zIndex: 1, marginTop: '4rem', display: 'flex', flexDirection: 'column', alignItems: 'center', gap: '0.75rem' }}>
         <p style={{ fontSize: '0.75rem', color: '#64748b', letterSpacing: '0.1em', textTransform: 'uppercase' }}>Get started</p>
         <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/home/pages/index.tsx
+          Edit app/modules/main/pages/index.tsx
         </code>
       </div>
 
@@ -1523,6 +1818,24 @@ export default async function HomePage() {
 }
 `;
 }
+function generate404Page() {
+  return `export const metadata = {
+  title: '404 - Page Not Found',
+  description: 'The page you are looking for does not exist.',
+  robots: 'noindex, nofollow',
+};
+
+export default function NotFoundPage() {
+  return (
+    <div style={{ minHeight: '100vh', display: 'flex', flexDirection: 'column', alignItems: 'center', justifyContent: 'center', fontFamily: 'system-ui, -apple-system, sans-serif', textAlign: 'center', padding: '2rem' }}>
+      <h1 style={{ fontSize: '4rem', margin: '0 0 1rem' }}>404</h1>
+      <p style={{ fontSize: '1.25rem', color: '#64748b', margin: '0 0 2rem' }}>Page not found</p>
+      <a href="/" style={{ color: '#6366f1', textDecoration: 'none', fontWeight: 500 }}>Go Home</a>
+    </div>
+  );
+}
+`;
+}
 
 // src/templates/post-build.ts
 function generatePostBuildMjs() {
@@ -1558,8 +1871,8 @@ function generateStylingFiles(config) {
     case "css-modules":
       files.set("app/shared/styles/tokens.css", generateTokensCss());
       files.set("app/shared/layouts/_layout.module.css", generateLayoutModuleCss());
-      files.set("app/modules/home/pages/index.module.css", generatePageModuleCss());
-      files.set("app/modules/home/layouts/_layout.module.css", generateLayoutModuleCss());
+      files.set("app/modules/main/pages/index.module.css", generatePageModuleCss());
+      files.set("app/modules/main/layouts/_layout.module.css", generateLayoutModuleCss());
       break;
     case "tailwind":
       files.set("tailwind.config.js", generateTailwindConfig());
@@ -1746,7 +2059,7 @@ function generateShadcnComponentsJson(config) {
 }
 
 // src/templates/tsconfig.ts
-function generateTsConfig() {
+function generateTsConfig(core = "preact") {
   const tsconfig = {
     compilerOptions: {
       target: "ESNext",
@@ -1759,6 +2072,7 @@ function generateTsConfig() {
       allowImportingTsExtensions: true,
       noEmit: true,
       jsx: "react-jsx",
+      jsxImportSource: core,
       paths: {
         "@shared/*": ["./app/shared/*"],
         "@modules/*": ["./app/modules/*"]
@@ -1819,20 +2133,37 @@ function generateViteConfig(config) {
   if (needsTailwind) {
     imports.push(`import tailwindcss from '@tailwindcss/vite';`);
   }
+  const hasSeo = config.plugins.includes("seo");
+  if (hasSeo) {
+    imports.push(`import { seo } from '@useavalon/seo';`);
+  }
   const hasAgentOptimization = config.plugins.includes("agent-optimization");
   if (hasAgentOptimization) {
     imports.push(`import { agentOptimization } from '@useavalon/agent-optimization';`);
   }
   const integrationsList = config.integrations.map((i) => `'${i}'`).join(", ");
   const pluginEntries = [];
+  if (hasSeo) {
+    pluginEntries.push(`    seo({
+      siteUrl: 'http://localhost:3000',
+      siteName: '${config.projectName.replace(/'/g, "\\'")}',
+      defaultDescription: 'Built with Avalon',
+      defaultOgImage: {
+        url: '/og-image.png',
+        width: 1200,
+        height: 630,
+      },
+      breadcrumbs: true,
+      speakable: true,
+    }),`);
+  }
   if (hasAgentOptimization) {
     pluginEntries.push(`    agentOptimization({
       sitemap: { siteUrl: 'http://localhost:3000' },
       markdown: true,
-      structuredData: true,
       llms: {
         siteUrl: 'http://localhost:3000',
-        siteName: 'My Avalon App',
+        siteName: '${config.projectName.replace(/'/g, "\\'")}',
         siteDescription: 'Built with Avalon',
         sections: { 'Pages': ['/'] },
       },
@@ -1842,12 +2173,20 @@ 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 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',`,
@@ -1862,6 +2201,7 @@ function generateViteConfig(config) {
     `        crawlLinks: true,`,
     `        ignore: [],`,
     `      },`,
+    ...cronLines,
     `    },`,
     `  });`,
     "",
@@ -1952,13 +2292,19 @@ 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/home/layouts/_layout.tsx"), generateHomeLayout(config));
-  await writeFile(join(targetDir, "app/modules/home/pages/index.tsx"), generateHomePage(config));
+  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, "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") {
@@ -1970,9 +2316,12 @@ async function scaffoldProject(config, targetDir) {
     await writeFile(join(targetDir, filePath), content);
   }
   await writeFile(join(targetDir, "public/favicon.ico"), getFaviconBuffer());
+  await writeFile(join(targetDir, "public/robots.txt"), generateRobotsTxt());
   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.`,
@@ -2018,6 +2367,7 @@ function formatSummary(config, scaffoldedInPlace = false) {
     `  Plugins:        ${plugins}`,
     `  Middleware:     ${config.middleware}`,
     `  Deploy:        ${deploy}`,
+    `  Cron:           ${config.cron ? "yes" : "no"}`,
     "",
     "  Next steps:",
     ...nextSteps,
@@ -2039,11 +2389,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         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 !== ".") {
@@ -2053,7 +2420,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) {
@@ -2070,4 +2438,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.23",
+	"version": "0.1.25",
 	"description": "Scaffold a new Avalon project with multi-framework islands architecture",
 	"license": "MIT",
 	"type": "module",