@lunora/cli 1.0.0-alpha.9 → 1.0.0-alpha.91

package/dist/packem_chunks/runInitCommand.mjs

@@ -1,19 +1,22 @@
-import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync, mkdtempSync, cpSync, rmSync, renameSync } from 'node:fs';
+import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync, rmSync, mkdtempSync, lstatSync, cpSync, renameSync } from 'node:fs';
 import { tmpdir } from 'node:os';
-import { detectFramework as detectFramework$1, isInteractive } from '@lunora/config';
+import { detectFramework as detectFramework$1, isInteractive, LUNA_ART, LUNA_NAME, LUNA_SIGNOFF, paintAnswer, BADGES } from '@lunora/config';
 import { walkSync } from '@visulima/fs';
 import { join as join$1, dirname as dirname$1, basename, resolve, relative } from '@visulima/path';
 import { downloadTemplate } from 'giget';
 import { modify, applyEdits } from 'jsonc-parser';
 import { join, dirname } from 'node:path';
-import { d as defineHandler } from '../packem_shared/command-BDXcJCCJ.mjs';
-import { a as detectInstalledManagers, i as installArgsFor } from '../packem_shared/detect-package-manager-DYp7n3mJ.mjs';
+import { d as defineHandler } from '../packem_shared/command-lYnl4QyF.mjs';
+import { d as detectPackageManager, a as detectInstalledManagers, i as installArgsFor, r as runScriptCommand } from '../packem_shared/detect-package-manager-v4hHpQd0.mjs';
 import MagicString from 'magic-string';
 import { Project, SyntaxKind } from 'ts-morph';
-import { c as resolveDistTag, d as resolveSourceRef, r as runAddCommand } from '../packem_shared/commands-CkkATMMx.mjs';
-import { defaultSpawner } from '../packem_shared/createRecordingSpawner-DxI3mebw.mjs';
-import { d as tuiOutro, e as tuiBanner, t as tuiText, f as tuiIntro, a as tuiSelect, w as withTuiSpinner, b as tuiConfirm, g as tuiMultiSelect } from '../packem_shared/tui-prompts-CA9lngSS.mjs';
-import { p as promptBucketName, w as withStorageBucketName, M as MAIL_DESTINATION_PROMPT, r as resolveTypedDestination, E as EMAIL_ITEM, f as withMailDestination, e as promptAuthProvider, c as promptDatabaseName, g as withAuthDatabaseName } from '../packem_shared/storage-Bjo35hPa.mjs';
+import { P as PromptCancelledError } from '../packem_shared/prompt-cancelled-APzX1Im-.mjs';
+import { c as resolveTagVersions, d as resolveSourceRef, e as resolvePinnedSourceRef, f as resolveDistTag, r as runAddCommand } from '../packem_shared/commands-D5Yxt9VY.mjs';
+import { defaultSpawner } from '../packem_shared/createRecordingSpawner-WuSn20kb.mjs';
+import { d as tuiMascot, e as tuiStep, f as tuiMoonrise, t as tuiText, g as tuiHeadline, h as tuiInfo, a as tuiSelect, b as tuiConfirm, w as withTuiSpinner, i as tuiNextSteps, j as tuiTasks, k as tuiMultiSelect, l as withTuiBadgeProgress } from '../packem_shared/tui-prompts-BjEN8XgP.mjs';
+import { logStep } from '../packem_shared/createLogger-CIWSHrTL.mjs';
+import { E as EMAIL_ITEM, p as promptBucketName, w as withStorageBucketName, M as MAIL_DESTINATION_PROMPT, r as resolveTypedDestination, f as withMailDestination, e as promptAuthProvider, c as promptDatabaseName, g as withAuthDatabaseName } from '../packem_shared/storage-BXU4ax4O.mjs';
+import dns from 'node:dns/promises';
 
 const GITHUB_CONTENT = `name: Deploy
 
@@ -285,47 +288,1057 @@ const patchViteConfig = (source) => {
   return { changed: true, code: ms.toString() };
 };
 
+const NETWORK_ERROR_PATTERN = /enotfound|eai_again|econnrefused|etimedout|network|fetch failed|getaddrinfo/u;
+const NOT_FOUND_ERROR_PATTERN = /404|not found|could not find|no such/u;
+const describeDownloadFailure = (error, context) => {
+  const raw = error instanceof Error ? error.message : String(error);
+  const lower = raw.toLowerCase();
+  const genericMessage = `failed to download template "${context.templateType}" from ${context.remote}: ${raw}`;
+  if (NOT_FOUND_ERROR_PATTERN.test(lower)) {
+    return {
+      hints: [
+        `Check the template name "${context.templateType}" and the ref "${context.ref}".`,
+        "List/inspect available templates, or target a branch/tag with `--ref <branch>`."
+      ],
+      message: `template "${context.templateType}" not found at ${context.remote}: ${raw}`
+    };
+  }
+  if (NETWORK_ERROR_PATTERN.test(lower)) {
+    return {
+      hints: [
+        "You appear to be offline or unable to reach GitHub.",
+        "To scaffold without a network, point at a local template root: `lunora init --from <dir>`."
+      ],
+      message: genericMessage
+    };
+  }
+  return {
+    hints: ["If this is a network/offline issue, scaffold from a local root with `lunora init --from <dir>`."],
+    message: genericMessage
+  };
+};
+
+const emitStep = async (type, message, answer) => {
+  if (isInteractive()) {
+    await tuiStep(BADGES[type], message, answer);
+    return;
+  }
+  process.stdout.write("\n");
+  if (answer === void 0 || answer === "") {
+    logStep(type, message);
+    return;
+  }
+  const dimmed = answer.split("\n").map((line) => paintAnswer(line)).join("\n");
+  logStep(type, `${message}
+${dimmed}`);
+};
+const emitMascot = async (logger) => {
+  if (isInteractive()) {
+    await tuiMascot();
+    return;
+  }
+  logger.info(`
+${LUNA_ART}
+${LUNA_NAME}: ${LUNA_SIGNOFF}`);
+};
+
 const STACK_FEATURE_OPTIONS = [
+  { description: "LLMs via Workers AI (summarize, generate, stream)", label: "AI", value: "ai" },
   { description: "Sign-up / sign-in (asks which provider)", label: "Authentication", value: "auth" },
-  { description: "Cloudflare Email Workers + a dev mail catcher", label: "Transactional email", value: "email" },
-  { description: "Typed R2 buckets + signed URLs (@lunora/storage)", label: "File storage", value: "storage" },
-  { description: "Token-bucket / sliding-window limits (@lunora/ratelimit)", label: "Rate limiting", value: "ratelimit" },
+  { description: "Snapshot + restore your Durable Object data", label: "Backups", value: "backup" },
+  { description: "Headless browser screenshots + PDFs", label: "Browser rendering", value: "browser" },
+  { description: "Zero Trust identity via Cloudflare Access", label: "Cloudflare Access", value: "cloudflare-access" },
   { description: "Scheduled jobs via Cron Triggers (@lunora/scheduler)", label: "Cron jobs", value: "crons" },
+  { description: "Cloudflare Email Workers + a dev mail catcher", label: "Transactional email", value: "email" },
+  { description: "OpenFeature feature flags (ctx.flags)", label: "Feature flags", value: "flags" },
+  { description: "External Postgres/MySQL via Hyperdrive", label: "Hyperdrive", value: "hyperdrive" },
+  { description: "Stripe-first payments (checkout, subscription, webhooks)", label: "Payments", value: "payment" },
   { description: "Live presence / who's-online over hibernated WebSockets", label: "Presence", value: "presence" },
-  { description: "Snapshot + restore your Durable Object data", label: "Backups", value: "backup" }
+  { description: "Async message queues (push/pull consumers)", label: "Queues", value: "queue" },
+  { description: "Typed R2 buckets + signed URLs (@lunora/storage)", label: "File storage", value: "storage" },
+  { description: "Durable long-running workflows (step.do, sleep, branch)", label: "Workflows", value: "workflow" }
 ];
-const applyAuthFeature = async (deps) => {
+const STACK_FEATURE_VALUES = STACK_FEATURE_OPTIONS.map((option) => option.value);
+const featureItem = (feature) => feature === "email" ? EMAIL_ITEM : feature;
+const parseFeatureList = (raw, warn) => {
+  const features = [];
+  for (const part of raw.split(",").map((entry) => entry.trim()).filter(Boolean)) {
+    if (STACK_FEATURE_VALUES.includes(part)) {
+      if (!features.includes(part)) {
+        features.push(part);
+      }
+    } else {
+      warn(`init: unknown --add feature "${part}" — expected ${STACK_FEATURE_VALUES.join(" | ")}; skipping.`);
+    }
+  }
+  return features;
+};
+const collectAuthFeature = async (deps) => {
   const provider = await promptAuthProvider(deps.select);
   const databaseName = await promptDatabaseName(deps.text, deps.projectName);
-  await deps.apply([provider], { transformManifest: (manifest) => withAuthDatabaseName(manifest, databaseName) });
+  return { label: "auth", names: [provider], transformManifest: (manifest) => withAuthDatabaseName(manifest, databaseName) };
 };
-const applyEmailFeature = async (deps) => {
+const collectEmailFeature = async (deps) => {
   const answer = await deps.text(MAIL_DESTINATION_PROMPT, { placeholder: "you@yourdomain.com" });
   const destination = resolveTypedDestination(answer, (message) => {
     deps.logger.warn(message);
   });
-  await deps.apply([EMAIL_ITEM], destination === void 0 ? void 0 : { transformManifest: (manifest) => withMailDestination(manifest, destination) });
+  return {
+    label: "email",
+    names: [EMAIL_ITEM],
+    transformManifest: destination === void 0 ? void 0 : (manifest) => withMailDestination(manifest, destination)
+  };
 };
-const applyStorageFeature = async (deps) => {
+const collectStorageFeature = async (deps) => {
   const bucketName = await promptBucketName(deps.text, deps.projectName);
-  await deps.apply(["storage"], { transformManifest: (manifest) => withStorageBucketName(manifest, bucketName) });
+  return { label: "storage", names: ["storage"], transformManifest: (manifest) => withStorageBucketName(manifest, bucketName) };
 };
-const FEATURE_HANDLERS = {
-  auth: applyAuthFeature,
-  email: applyEmailFeature,
-  storage: applyStorageFeature
+const FEATURE_COLLECTORS = {
+  auth: collectAuthFeature,
+  email: collectEmailFeature,
+  storage: collectStorageFeature
 };
 const offerRegistryExtras = async (deps) => {
+  if (deps.preselected !== void 0 && deps.preselected.length > 0) {
+    await deps.applyAll(
+      deps.preselected.map((feature) => {
+        return { label: feature, names: [featureItem(feature)] };
+      })
+    );
+    return;
+  }
   if (!deps.interactive) {
-    deps.logger.info("tip: add features later with `lunora add <auth|email|storage|ratelimit|crons|presence|backup>`.");
+    deps.logger.info(
+      // eslint-disable-next-line no-secrets/no-secrets -- the pipe-separated feature list in this tip is a UI prompt, not a credential
+      "tip: add features later with `lunora add <ai|auth|backup|browser|cloudflare-access|crons|email|flags|hyperdrive|payment|presence|queue|storage|workflow>`."
+    );
     return;
   }
   const picked = await deps.multiSelect("Which features do you want to add?", STACK_FEATURE_OPTIONS, { defaults: [] });
+  if (picked.length === 0) {
+    return;
+  }
+  const plans = [];
   for (const feature of picked) {
-    const handler = FEATURE_HANDLERS[feature];
-    await (handler ? handler(deps) : deps.apply([feature]));
+    const collect = FEATURE_COLLECTORS[feature];
+    plans.push(collect ? await collect(deps) : { label: feature, names: [feature] });
   }
+  await deps.applyAll(plans);
+};
+
+const LOGO_PATH = "M 259.500 10.552 C 220.080 15.859, 182.424 32.566, 152.500 58.025 C 110.179 94.031, 85.380 137.183, 77.518 188.500 C 75.410 202.255, 74.569 225.677, 75.796 236.466 C 76.757 244.917, 76.683 245.692, 74.518 249.966 C 63.118 272.466, 53.141 303.876, 51.382 322.799 L 50.718 329.943 71.960 320.471 C 83.643 315.262, 93.326 311, 93.478 311 C 93.630 311, 96.547 316.063, 99.959 322.250 C 103.371 328.438, 107.249 334.850, 108.577 336.500 L 110.990 339.500 110.981 336 C 110.977 334.075, 111.499 324.991, 112.143 315.813 L 113.312 299.127 121.406 293.336 C 132.495 285.403, 149.593 271.554, 161 261.268 C 171.556 251.748, 189.116 235, 188.540 235 C 188.337 235, 183.069 238.648, 176.835 243.106 C 142.318 267.789, 68.537 314, 63.646 314 C 61.843 314, 72.791 281.179, 80.905 262.259 C 92.233 235.845, 107.473 212.389, 132.106 183.453 L 138.451 176 148.268 176 C 176.192 176, 197.512 187.154, 212.868 209.797 C 216.470 215.108, 217.035 216.595, 216.477 219.297 C 211.386 243.968, 202.359 274.496, 193.797 296 C 183.898 320.861, 167.147 352.101, 152.395 373.215 L 147.004 380.930 152.891 385.830 C 161.400 392.911, 165.563 396, 166.594 395.998 C 167.092 395.998, 168.772 391.641, 170.327 386.317 C 176.279 365.934, 188.422 338.749, 200.942 317.778 C 223.060 280.731, 256.432 244.369, 294.500 215.836 C 309.956 204.252, 313.937 201.603, 314.719 202.385 C 315.116 202.783, 315.449 213.096, 315.460 225.304 C 315.474 241.855, 315.021 250.405, 313.680 258.924 C 307.009 301.272, 291.175 336.677, 263.112 372 C 255.259 381.883, 227.182 410.673, 218.516 417.727 L 213.532 421.783 223.439 424.880 C 281.705 443.093, 349.165 436.018, 398.616 406.508 C 446.728 377.797, 483.322 331.466, 497.366 281.481 C 503.381 260.075, 504.480 250.741, 504.491 221 C 504.501 191.997, 503.598 184.047, 497.987 163.732 C 484.768 115.871, 452.505 72.708, 407.718 42.964 C 381.051 25.254, 352.818 14.828, 319.695 10.460 C 305.932 8.645, 273.298 8.695, 259.500 10.552";
+const WELCOME_CSS = `/* The welcome page is a full-bleed starter — reset the browser's default
+   body margin/padding so it sits flush; everything else is scoped under
+   .lunora-welcome (collision-safe). */
+body {
+    margin: 0;
+    padding: 0;
+}
+
+.lunora-welcome {
+    --cyan: hsl(186 84% 56%); --violet: hsl(256 72% 68%); --rose: hsl(330 80% 64%);
+    --ribbon: linear-gradient(115deg, var(--cyan), var(--violet) 52%, var(--rose));
+    --sans: "Geist Sans", ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+    --mono: "Geist Mono", ui-monospace, "SF Mono", Menlo, Consolas, monospace;
+    /* NIGHT (default) */
+    --bg: #0e0e11; --surface: hsl(240 12% 8% / 0.72); --surface-2: hsl(240 11% 11% / 0.82);
+    --line: hsl(0 0% 100% / 0.08); --line-2: hsl(0 0% 100% / 0.14);
+    --t-display: hsl(228 30% 97%); --t-primary: hsl(228 26% 90%); --t-secondary: hsl(228 12% 62%); --t-faint: hsl(228 10% 44%);
+    --logo: hsl(228 30% 97%); --accent: var(--violet); --shot-bg: hsl(240 12% 6%);
+    --glow-1: hsl(256 80% 52% / 0.30); --glow-2: hsl(196 84% 52% / 0.13); --arc: hsl(256 60% 70% / 0.11);
+
+    position: relative; min-height: 100vh; background: var(--bg); color: var(--t-primary);
+    font-family: var(--sans); line-height: 1.55; -webkit-font-smoothing: antialiased; overflow-x: hidden;
+    transition: background .3s, color .3s;
+}
+.lunora-welcome[data-theme="light"] {
+    --bg: hsl(228 32% 97%); --surface: hsl(0 0% 100% / 0.82); --surface-2: hsl(0 0% 100% / 0.95);
+    --line: hsl(228 16% 88%); --line-2: hsl(228 14% 80%);
+    --t-display: hsl(240 14% 10%); --t-primary: hsl(240 12% 18%); --t-secondary: hsl(235 9% 42%); --t-faint: hsl(235 8% 58%);
+    --logo: hsl(240 16% 9%); --accent: hsl(256 58% 56%); --shot-bg: hsl(228 26% 99%);
+    --glow-1: hsl(256 80% 60% / 0.14); --glow-2: hsl(196 84% 58% / 0.08); --arc: hsl(256 40% 55% / 0.12);
+}
+.lunora-welcome *, .lunora-welcome *::before, .lunora-welcome *::after { box-sizing: border-box; }
+.lunora-welcome a { color: inherit; text-decoration: none; }
+.lunora-welcome button { font-family: inherit; cursor: pointer; }
+.lunora-welcome ::selection { background: hsl(256 72% 68% / 0.3); }
+.lunora-welcome code { font-family: var(--mono); }
+
+/* glow background */
+.lunora-welcome .lw-bg { position: fixed; inset: 0; z-index: 0; pointer-events: none; overflow: hidden; }
+.lunora-welcome .lw-bg .glow { position: absolute; left: 50%; top: -4%; width: 860px; height: 720px; transform: translateX(-50%);
+    border-radius: 50%; background: radial-gradient(circle at 50% 50%, var(--glow-1), var(--glow-2) 40%, transparent 66%); }
+.lunora-welcome .lw-bg .arc { position: absolute; left: 50%; border-radius: 50%; border: 1px solid var(--arc); transform: translateX(-50%); }
+.lunora-welcome .lw-bg .arc.a1 { top: -340px; width: 980px; height: 980px; }
+.lunora-welcome .lw-bg .arc.a2 { top: -240px; width: 720px; height: 720px; opacity: .7; }
+
+/* theme toggle */
+.lunora-welcome .lw-toggle { position: fixed; z-index: 5; top: 20px; right: clamp(16px,4vw,36px); display: inline-flex; align-items: center;
+    gap: 7px; border: 1px solid var(--line-2); background: var(--surface); backdrop-filter: blur(12px); color: var(--t-secondary);
+    font-family: var(--mono); font-size: 10.5px; letter-spacing: .1em; text-transform: uppercase; padding: 7px 11px; transition: .15s; }
+.lunora-welcome .lw-toggle:hover { color: var(--t-display); border-color: var(--accent); }
+.lunora-welcome .lw-toggle svg { width: 13px; height: 13px; }
+
+.lunora-welcome .lw-wrap { position: relative; z-index: 2; width: 100%; max-width: 1080px; margin: 0 auto;
+    padding: clamp(44px,8vh,92px) clamp(20px,5vw,48px); display: flex; flex-direction: column; min-height: 100vh; }
+.lunora-welcome .brand { display: flex; align-items: center; justify-content: center; gap: 15px; margin-bottom: clamp(38px,6vh,68px); color: var(--logo); }
+.lunora-welcome .brand svg { width: 54px; height: auto; display: block; }
+.lunora-welcome .brand .word { font-size: 34px; font-weight: 600; letter-spacing: -0.03em; color: var(--t-display); }
+
+.lunora-welcome .grid { display: grid; grid-template-columns: 1.06fr 0.94fr; gap: 16px; align-items: stretch; flex: 1; max-height: 580px; }
+@media (max-width: 820px) { .lunora-welcome .grid { grid-template-columns: 1fr; max-height: none; } }
+
+.lunora-welcome .card { border: 1px solid var(--line); background: var(--surface); backdrop-filter: blur(10px); transition: border-color .2s, background .2s; }
+.lunora-welcome .card:hover { border-color: var(--line-2); background: var(--surface-2); }
+.lunora-welcome .card:hover .arrow { color: var(--accent); transform: translateX(3px); }
+.lunora-welcome .arrow { color: var(--t-faint); transition: color .2s, transform .2s; }
+.lunora-welcome .arrow svg { width: 20px; height: 20px; display: block; }
+.lunora-welcome .ic { display: grid; place-items: center; color: var(--accent);
+    border: 1px solid color-mix(in oklab, var(--accent) 36%, transparent); background: color-mix(in oklab, var(--accent) 12%, transparent); }
+.lunora-welcome .ic svg { display: block; }
+
+/* left feature card — stretches to fill the box height */
+.lunora-welcome .feature { padding: clamp(18px,2vw,24px); display: flex; flex-direction: column; }
+.lunora-welcome .shot { border: 1px solid var(--line); overflow: hidden; background: var(--shot-bg);
+    -webkit-mask-image: linear-gradient(to bottom, #000 56%, transparent 100%); mask-image: linear-gradient(to bottom, #000 56%, transparent 100%); }
+.lunora-welcome .shot .top { display: flex; align-items: center; gap: 12px; padding: 11px 14px; border-bottom: 1px solid var(--line); }
+.lunora-welcome .shot .wm { display: flex; align-items: center; gap: 7px; font-size: 12px; font-weight: 600; color: var(--t-primary); }
+.lunora-welcome .shot .wm i { width: 11px; height: 11px; background: var(--ribbon); -webkit-mask: radial-gradient(circle,#000 60%,transparent 62%); mask: radial-gradient(circle,#000 60%,transparent 62%); }
+.lunora-welcome .shot .search { flex: 1; height: 22px; border: 1px solid var(--line); border-radius: 4px; }
+.lunora-welcome .shot .ver { font-family: var(--mono); font-size: 8px; letter-spacing: .08em; color: var(--t-faint); }
+.lunora-welcome .shot .body { display: grid; grid-template-columns: 92px 1fr; min-height: 224px; }
+.lunora-welcome .shot .nav { border-right: 1px solid var(--line); padding: 14px 12px; display: flex; flex-direction: column; gap: 11px; }
+.lunora-welcome .shot .nav i, .lunora-welcome .shot .doc i { height: 5px; border-radius: 2px; background: var(--line); }
+.lunora-welcome .shot .doc { padding: 16px 18px; display: flex; flex-direction: column; gap: 9px; }
+.lunora-welcome .shot .doc .h { height: 8px; width: 46%; border-radius: 2px; background: var(--line-2); margin-bottom: 5px; }
+.lunora-welcome .shot .doc .accent { height: 5px; width: 26%; border-radius: 2px; background: var(--accent); }
+.lunora-welcome .feature .info { margin-top: auto; padding-top: clamp(18px,2.4vh,28px); }
+.lunora-welcome .feature .ic { width: 40px; height: 40px; margin-bottom: 15px; }
+.lunora-welcome .feature .ic svg { width: 19px; height: 19px; }
+.lunora-welcome .feature h2 { margin: 0 0 10px; font-size: 19px; font-weight: 600; letter-spacing: -0.015em; color: var(--t-display); }
+.lunora-welcome .feature .row { display: flex; align-items: flex-end; gap: 16px; }
+.lunora-welcome .feature p { margin: 0; color: var(--t-secondary); font-size: 14px; max-width: 50ch; }
+.lunora-welcome .feature .row .arrow { margin-left: auto; }
+
+/* right stack — smaller cards, spread to align bottoms with the feature */
+.lunora-welcome .stack { display: flex; flex-direction: column; gap: 16px; height: 100%; }
+.lunora-welcome .mini { flex: 1; padding: 15px 17px; display: flex; align-items: center; gap: 16px; min-height: 0; }
+.lunora-welcome .mini .mc { flex: 1; }
+.lunora-welcome .mini .ic { width: 32px; height: 32px; margin-bottom: 10px; }
+.lunora-welcome .mini .ic svg { width: 16px; height: 16px; }
+.lunora-welcome .mini h3 { margin: 0 0 5px; font-size: 16px; font-weight: 600; letter-spacing: -0.01em; color: var(--t-display); }
+.lunora-welcome .mini p { margin: 0; color: var(--t-secondary); font-size: 12.5px; line-height: 1.45; }
+
+.lunora-welcome .lw-foot { text-align: center; padding-top: 26px; font-family: var(--mono); font-size: 11px; letter-spacing: .1em; text-transform: uppercase; color: var(--t-faint); }
+
+@media (prefers-reduced-motion: reduce) { .lunora-welcome * { transition: none !important; } }
+`;
+const REACT_APP = `import { useEffect, useState } from "react";
+
+type Theme = "dark" | "light";
+
+export default function App() {
+    // Default to "dark" for a stable first paint, then reconcile to the OS
+    // preference; the toggle takes over after that.
+    const [theme, setTheme] = useState<Theme>("dark");
+
+    useEffect(() => {
+        if (typeof window !== "undefined" && window.matchMedia("(prefers-color-scheme: light)").matches) {
+            setTheme("light");
+        }
+    }, []);
+
+    const isLight = theme === "light";
+
+    return (
+        <div className="lunora-welcome" data-theme={theme}>
+            <div className="lw-bg">
+                <div className="arc a1" />
+                <div className="arc a2" />
+                <div className="glow" />
+            </div>
+
+            <button className="lw-toggle" type="button" aria-label="Toggle color theme" onClick={() => setTheme(isLight ? "dark" : "light")}>
+                {isLight ? (
+                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.8">
+                        <path d="M21 12.8A9 9 0 1 1 11.2 3a7 7 0 0 0 9.8 9.8z" />
+                    </svg>
+                ) : (
+                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.8">
+                        <circle cx="12" cy="12" r="4" />
+                        <path d="M12 2v2M12 20v2M4 12H2M22 12h-2M5 5l1.5 1.5M17.5 17.5 19 19M19 5l-1.5 1.5M6.5 17.5 5 19" />
+                    </svg>
+                )}
+                <span>{isLight ? "Ivory" : "Night"}</span>
+            </button>
+
+            <div className="lw-wrap">
+                <div className="brand">
+                    <svg viewBox="0 0 543 446" role="img" aria-label="Lunora">
+                        <path d="${LOGO_PATH}" fill="currentColor" fillRule="evenodd" />
+                    </svg>
+                    <span className="word">Lunora</span>
+                </div>
+
+                <div className="grid">
+                    <a className="card feature" href="https://lunora.sh/docs">
+                        <div className="shot" aria-hidden="true">
+                            <div className="top">
+                                <span className="wm">
+                                    <i /> Lunora
+                                </span>
+                                <span className="search" />
+                                <span className="ver">v0.1</span>
+                            </div>
+                            <div className="body">
+                                <div className="nav">
+                                    <i style={{ width: "80%" }} />
+                                    <i style={{ width: "60%" }} />
+                                    <i style={{ width: "72%" }} />
+                                    <i style={{ width: "50%" }} />
+                                    <i style={{ width: "66%" }} />
+                                    <i style={{ width: "44%" }} />
+                                    <i style={{ width: "58%" }} />
+                                </div>
+                                <div className="doc">
+                                    <span className="h" />
+                                    <i style={{ width: "92%" }} />
+                                    <i style={{ width: "88%" }} />
+                                    <span className="accent" />
+                                    <i style={{ width: "80%" }} />
+                                    <i style={{ width: "90%" }} />
+                                    <i style={{ width: "72%" }} />
+                                    <i style={{ width: "84%" }} />
+                                    <i style={{ width: "78%" }} />
+                                </div>
+                            </div>
+                        </div>
+                        <div className="info">
+                            <span className="ic">
+                                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7">
+                                    <path d="M4 5a2 2 0 0 1 2-2h9l5 5v11a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2z" />
+                                    <path d="M14 3v5h5" />
+                                </svg>
+                            </span>
+                            <h2>Documentation</h2>
+                            <div className="row">
+                                <p>
+                                    Schemas, queries, live subscriptions, sharding, and edge deploy — start to finish. New here or coming from Convex or tRPC,
+                                    you'll have a live app fast.
+                                </p>
+                                <span className="arrow">
+                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
+                                        <path d="M5 12h14M13 6l6 6-6 6" />
+                                    </svg>
+                                </span>
+                            </div>
+                        </div>
+                    </a>
+
+                    <div className="stack">
+                        <a className="card mini" href="https://lunora.sh/blog">
+                            <div className="mc">
+                                <span className="ic">
+                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7">
+                                        <path d="M5 4h11a1 1 0 0 1 1 1v14a1 1 0 0 1-1 1H6a2 2 0 0 1-2-2V5a1 1 0 0 1 1-1zM8 8h7M8 12h7M8 16h4" />
+                                    </svg>
+                                </span>
+                                <h3>Blog</h3>
+                                <p>Product updates, deep dives, and what's new in Lunora.</p>
+                            </div>
+                            <span className="arrow">
+                                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
+                                    <path d="M5 12h14M13 6l6 6-6 6" />
+                                </svg>
+                            </span>
+                        </a>
+                        <a className="card mini" href="/_lunora">
+                            <div className="mc">
+                                <span className="ic">
+                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7">
+                                        <rect x="3" y="3" width="18" height="18" rx="1" />
+                                        <path d="M3 9h18M9 21V9" />
+                                    </svg>
+                                </span>
+                                <h3>Lunora Studio</h3>
+                                <p>Local admin for schema, data, logs, and advisors.</p>
+                            </div>
+                            <span className="arrow">
+                                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
+                                    <path d="M5 12h14M13 6l6 6-6 6" />
+                                </svg>
+                            </span>
+                        </a>
+                        <a className="card mini" href="https://lunora.sh/packages">
+                            <div className="mc">
+                                <span className="ic">
+                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7">
+                                        <path d="M12 2 3 7v10l9 5 9-5V7z" />
+                                        <path d="M3 7l9 5 9-5M12 12v10" />
+                                    </svg>
+                                </span>
+                                <h3>Cloudflare ecosystem</h3>
+                                <p>Auth, mail, storage, AI, payments — one deploy.</p>
+                            </div>
+                            <span className="arrow">
+                                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
+                                    <path d="M5 12h14M13 6l6 6-6 6" />
+                                </svg>
+                            </span>
+                        </a>
+                    </div>
+                </div>
+
+                <div className="lw-foot">Running on Lunora · Vite + React</div>
+            </div>
+        </div>
+    );
+}
+`;
+const VUE_APP = `<script setup lang="ts">
+import { onMounted, ref } from "vue";
+
+// Default to "dark" for a stable first paint, then reconcile to the OS
+// preference; the toggle takes over after that.
+const theme = ref<"dark" | "light">("dark");
+
+onMounted(() => {
+    if (window.matchMedia("(prefers-color-scheme: light)").matches) {
+        theme.value = "light";
+    }
+});
+
+const toggle = (): void => {
+    theme.value = theme.value === "light" ? "dark" : "light";
 };
+<\/script>
+
+<template>
+    <div class="lunora-welcome" :data-theme="theme">
+        <div class="lw-bg">
+            <div class="arc a1" />
+            <div class="arc a2" />
+            <div class="glow" />
+        </div>
+
+        <button class="lw-toggle" type="button" aria-label="Toggle color theme" @click="toggle">
+            <svg v-if="theme === 'light'" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8">
+                <path d="M21 12.8A9 9 0 1 1 11.2 3a7 7 0 0 0 9.8 9.8z" />
+            </svg>
+            <svg v-else viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8">
+                <circle cx="12" cy="12" r="4" />
+                <path d="M12 2v2M12 20v2M4 12H2M22 12h-2M5 5l1.5 1.5M17.5 17.5 19 19M19 5l-1.5 1.5M6.5 17.5 5 19" />
+            </svg>
+            <span>{{ theme === "light" ? "Ivory" : "Night" }}</span>
+        </button>
+
+        <div class="lw-wrap">
+            <div class="brand">
+                <svg viewBox="0 0 543 446" role="img" aria-label="Lunora">
+                    <path d="${LOGO_PATH}" fill="currentColor" fill-rule="evenodd" />
+                </svg>
+                <span class="word">Lunora</span>
+            </div>
+
+            <div class="grid">
+                <a class="card feature" href="https://lunora.sh/docs">
+                    <div class="shot" aria-hidden="true">
+                        <div class="top">
+                            <span class="wm"><i /> Lunora</span>
+                            <span class="search" />
+                            <span class="ver">v0.1</span>
+                        </div>
+                        <div class="body">
+                            <div class="nav">
+                                <i style="width: 80%" />
+                                <i style="width: 60%" />
+                                <i style="width: 72%" />
+                                <i style="width: 50%" />
+                                <i style="width: 66%" />
+                                <i style="width: 44%" />
+                                <i style="width: 58%" />
+                            </div>
+                            <div class="doc">
+                                <span class="h" />
+                                <i style="width: 92%" />
+                                <i style="width: 88%" />
+                                <span class="accent" />
+                                <i style="width: 80%" />
+                                <i style="width: 90%" />
+                                <i style="width: 72%" />
+                                <i style="width: 84%" />
+                                <i style="width: 78%" />
+                            </div>
+                        </div>
+                    </div>
+                    <div class="info">
+                        <span class="ic">
+                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7">
+                                <path d="M4 5a2 2 0 0 1 2-2h9l5 5v11a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2z" />
+                                <path d="M14 3v5h5" />
+                            </svg>
+                        </span>
+                        <h2>Documentation</h2>
+                        <div class="row">
+                            <p>
+                                Schemas, queries, live subscriptions, sharding, and edge deploy — start to finish. New here or coming from Convex or tRPC,
+                                you'll have a live app fast.
+                            </p>
+                            <span class="arrow">
+                                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                                    <path d="M5 12h14M13 6l6 6-6 6" />
+                                </svg>
+                            </span>
+                        </div>
+                    </div>
+                </a>
+
+                <div class="stack">
+                    <a class="card mini" href="https://lunora.sh/blog">
+                        <div class="mc">
+                            <span class="ic">
+                                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7">
+                                    <path d="M5 4h11a1 1 0 0 1 1 1v14a1 1 0 0 1-1 1H6a2 2 0 0 1-2-2V5a1 1 0 0 1 1-1zM8 8h7M8 12h7M8 16h4" />
+                                </svg>
+                            </span>
+                            <h3>Blog</h3>
+                            <p>Product updates, deep dives, and what's new in Lunora.</p>
+                        </div>
+                        <span class="arrow">
+                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                                <path d="M5 12h14M13 6l6 6-6 6" />
+                            </svg>
+                        </span>
+                    </a>
+                    <a class="card mini" href="/_lunora">
+                        <div class="mc">
+                            <span class="ic">
+                                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7">
+                                    <rect x="3" y="3" width="18" height="18" rx="1" />
+                                    <path d="M3 9h18M9 21V9" />
+                                </svg>
+                            </span>
+                            <h3>Lunora Studio</h3>
+                            <p>Local admin for schema, data, logs, and advisors.</p>
+                        </div>
+                        <span class="arrow">
+                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                                <path d="M5 12h14M13 6l6 6-6 6" />
+                            </svg>
+                        </span>
+                    </a>
+                    <a class="card mini" href="https://lunora.sh/packages">
+                        <div class="mc">
+                            <span class="ic">
+                                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7">
+                                    <path d="M12 2 3 7v10l9 5 9-5V7z" />
+                                    <path d="M3 7l9 5 9-5M12 12v10" />
+                                </svg>
+                            </span>
+                            <h3>Cloudflare ecosystem</h3>
+                            <p>Auth, mail, storage, AI, payments — one deploy.</p>
+                        </div>
+                        <span class="arrow">
+                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                                <path d="M5 12h14M13 6l6 6-6 6" />
+                            </svg>
+                        </span>
+                    </a>
+                </div>
+            </div>
+
+            <div class="lw-foot">Running on Lunora · Vite + Vue</div>
+        </div>
+    </div>
+</template>
+`;
+const SOLID_APP = `import { createSignal, onMount } from "solid-js";
+
+export default function App() {
+    // Default to "dark" for a stable first paint, then reconcile to the OS
+    // preference; the toggle takes over after that.
+    const [theme, setTheme] = createSignal<"dark" | "light">("dark");
+
+    onMount(() => {
+        if (window.matchMedia("(prefers-color-scheme: light)").matches) {
+            setTheme("light");
+        }
+    });
+
+    const isLight = () => theme() === "light";
+
+    return (
+        <div class="lunora-welcome" data-theme={theme()}>
+            <div class="lw-bg">
+                <div class="arc a1" />
+                <div class="arc a2" />
+                <div class="glow" />
+            </div>
+
+            <button class="lw-toggle" type="button" aria-label="Toggle color theme" onClick={() => setTheme(isLight() ? "dark" : "light")}>
+                {isLight() ? (
+                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8">
+                        <path d="M21 12.8A9 9 0 1 1 11.2 3a7 7 0 0 0 9.8 9.8z" />
+                    </svg>
+                ) : (
+                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8">
+                        <circle cx="12" cy="12" r="4" />
+                        <path d="M12 2v2M12 20v2M4 12H2M22 12h-2M5 5l1.5 1.5M17.5 17.5 19 19M19 5l-1.5 1.5M6.5 17.5 5 19" />
+                    </svg>
+                )}
+                <span>{isLight() ? "Ivory" : "Night"}</span>
+            </button>
+
+            <div class="lw-wrap">
+                <div class="brand">
+                    <svg viewBox="0 0 543 446" role="img" aria-label="Lunora">
+                        <path d="${LOGO_PATH}" fill="currentColor" fill-rule="evenodd" />
+                    </svg>
+                    <span class="word">Lunora</span>
+                </div>
+
+                <div class="grid">
+                    <a class="card feature" href="https://lunora.sh/docs">
+                        <div class="shot" aria-hidden="true">
+                            <div class="top">
+                                <span class="wm">
+                                    <i /> Lunora
+                                </span>
+                                <span class="search" />
+                                <span class="ver">v0.1</span>
+                            </div>
+                            <div class="body">
+                                <div class="nav">
+                                    <i style={{ width: "80%" }} />
+                                    <i style={{ width: "60%" }} />
+                                    <i style={{ width: "72%" }} />
+                                    <i style={{ width: "50%" }} />
+                                    <i style={{ width: "66%" }} />
+                                    <i style={{ width: "44%" }} />
+                                    <i style={{ width: "58%" }} />
+                                </div>
+                                <div class="doc">
+                                    <span class="h" />
+                                    <i style={{ width: "92%" }} />
+                                    <i style={{ width: "88%" }} />
+                                    <span class="accent" />
+                                    <i style={{ width: "80%" }} />
+                                    <i style={{ width: "90%" }} />
+                                    <i style={{ width: "72%" }} />
+                                    <i style={{ width: "84%" }} />
+                                    <i style={{ width: "78%" }} />
+                                </div>
+                            </div>
+                        </div>
+                        <div class="info">
+                            <span class="ic">
+                                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7">
+                                    <path d="M4 5a2 2 0 0 1 2-2h9l5 5v11a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2z" />
+                                    <path d="M14 3v5h5" />
+                                </svg>
+                            </span>
+                            <h2>Documentation</h2>
+                            <div class="row">
+                                <p>
+                                    Schemas, queries, live subscriptions, sharding, and edge deploy — start to finish. New here or coming from Convex or tRPC,
+                                    you'll have a live app fast.
+                                </p>
+                                <span class="arrow">
+                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                                        <path d="M5 12h14M13 6l6 6-6 6" />
+                                    </svg>
+                                </span>
+                            </div>
+                        </div>
+                    </a>
+
+                    <div class="stack">
+                        <a class="card mini" href="https://lunora.sh/blog">
+                            <div class="mc">
+                                <span class="ic">
+                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7">
+                                        <path d="M5 4h11a1 1 0 0 1 1 1v14a1 1 0 0 1-1 1H6a2 2 0 0 1-2-2V5a1 1 0 0 1 1-1zM8 8h7M8 12h7M8 16h4" />
+                                    </svg>
+                                </span>
+                                <h3>Blog</h3>
+                                <p>Product updates, deep dives, and what's new in Lunora.</p>
+                            </div>
+                            <span class="arrow">
+                                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                                    <path d="M5 12h14M13 6l6 6-6 6" />
+                                </svg>
+                            </span>
+                        </a>
+                        <a class="card mini" href="/_lunora">
+                            <div class="mc">
+                                <span class="ic">
+                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7">
+                                        <rect x="3" y="3" width="18" height="18" rx="1" />
+                                        <path d="M3 9h18M9 21V9" />
+                                    </svg>
+                                </span>
+                                <h3>Lunora Studio</h3>
+                                <p>Local admin for schema, data, logs, and advisors.</p>
+                            </div>
+                            <span class="arrow">
+                                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                                    <path d="M5 12h14M13 6l6 6-6 6" />
+                                </svg>
+                            </span>
+                        </a>
+                        <a class="card mini" href="https://lunora.sh/packages">
+                            <div class="mc">
+                                <span class="ic">
+                                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7">
+                                        <path d="M12 2 3 7v10l9 5 9-5V7z" />
+                                        <path d="M3 7l9 5 9-5M12 12v10" />
+                                    </svg>
+                                </span>
+                                <h3>Cloudflare ecosystem</h3>
+                                <p>Auth, mail, storage, AI, payments — one deploy.</p>
+                            </div>
+                            <span class="arrow">
+                                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                                    <path d="M5 12h14M13 6l6 6-6 6" />
+                                </svg>
+                            </span>
+                        </a>
+                    </div>
+                </div>
+
+                <div class="lw-foot">Running on Lunora · Vite + Solid</div>
+            </div>
+        </div>
+    );
+}
+`;
+const SVELTE_APP = `<script lang="ts">
+    import { onMount } from "svelte";
+
+    // Default to "dark" for a stable first paint, then reconcile to the OS
+    // preference; the toggle takes over after that.
+    let theme = $state<"dark" | "light">("dark");
+    const isLight = $derived(theme === "light");
+
+    onMount(() => {
+        if (window.matchMedia("(prefers-color-scheme: light)").matches) {
+            theme = "light";
+        }
+    });
+
+    const toggle = (): void => {
+        theme = theme === "light" ? "dark" : "light";
+    };
+<\/script>
+
+<div class="lunora-welcome" data-theme={theme}>
+    <div class="lw-bg">
+        <div class="arc a1"></div>
+        <div class="arc a2"></div>
+        <div class="glow"></div>
+    </div>
+
+    <button class="lw-toggle" type="button" aria-label="Toggle color theme" onclick={toggle}>
+        {#if isLight}
+            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8">
+                <path d="M21 12.8A9 9 0 1 1 11.2 3a7 7 0 0 0 9.8 9.8z" />
+            </svg>
+        {:else}
+            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8">
+                <circle cx="12" cy="12" r="4" />
+                <path d="M12 2v2M12 20v2M4 12H2M22 12h-2M5 5l1.5 1.5M17.5 17.5 19 19M19 5l-1.5 1.5M6.5 17.5 5 19" />
+            </svg>
+        {/if}
+        <span>{isLight ? "Ivory" : "Night"}</span>
+    </button>
+
+    <div class="lw-wrap">
+        <div class="brand">
+            <svg viewBox="0 0 543 446" role="img" aria-label="Lunora">
+                <path d="${LOGO_PATH}" fill="currentColor" fill-rule="evenodd" />
+            </svg>
+            <span class="word">Lunora</span>
+        </div>
+
+        <div class="grid">
+            <a class="card feature" href="https://lunora.sh/docs">
+                <div class="shot" aria-hidden="true">
+                    <div class="top">
+                        <span class="wm"><i></i> Lunora</span>
+                        <span class="search"></span>
+                        <span class="ver">v0.1</span>
+                    </div>
+                    <div class="body">
+                        <div class="nav">
+                            <i style="width: 80%"></i>
+                            <i style="width: 60%"></i>
+                            <i style="width: 72%"></i>
+                            <i style="width: 50%"></i>
+                            <i style="width: 66%"></i>
+                            <i style="width: 44%"></i>
+                            <i style="width: 58%"></i>
+                        </div>
+                        <div class="doc">
+                            <span class="h"></span>
+                            <i style="width: 92%"></i>
+                            <i style="width: 88%"></i>
+                            <span class="accent"></span>
+                            <i style="width: 80%"></i>
+                            <i style="width: 90%"></i>
+                            <i style="width: 72%"></i>
+                            <i style="width: 84%"></i>
+                            <i style="width: 78%"></i>
+                        </div>
+                    </div>
+                </div>
+                <div class="info">
+                    <span class="ic">
+                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7">
+                            <path d="M4 5a2 2 0 0 1 2-2h9l5 5v11a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2z" />
+                            <path d="M14 3v5h5" />
+                        </svg>
+                    </span>
+                    <h2>Documentation</h2>
+                    <div class="row">
+                        <p>
+                            Schemas, queries, live subscriptions, sharding, and edge deploy — start to finish. New here or coming from Convex or tRPC,
+                            you'll have a live app fast.
+                        </p>
+                        <span class="arrow">
+                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                                <path d="M5 12h14M13 6l6 6-6 6" />
+                            </svg>
+                        </span>
+                    </div>
+                </div>
+            </a>
+
+            <div class="stack">
+                <a class="card mini" href="https://lunora.sh/blog">
+                    <div class="mc">
+                        <span class="ic">
+                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7">
+                                <path d="M5 4h11a1 1 0 0 1 1 1v14a1 1 0 0 1-1 1H6a2 2 0 0 1-2-2V5a1 1 0 0 1 1-1zM8 8h7M8 12h7M8 16h4" />
+                            </svg>
+                        </span>
+                        <h3>Blog</h3>
+                        <p>Product updates, deep dives, and what's new in Lunora.</p>
+                    </div>
+                    <span class="arrow">
+                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                            <path d="M5 12h14M13 6l6 6-6 6" />
+                        </svg>
+                    </span>
+                </a>
+                <a class="card mini" href="/_lunora">
+                    <div class="mc">
+                        <span class="ic">
+                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7">
+                                <rect x="3" y="3" width="18" height="18" rx="1" />
+                                <path d="M3 9h18M9 21V9" />
+                            </svg>
+                        </span>
+                        <h3>Lunora Studio</h3>
+                        <p>Local admin for schema, data, logs, and advisors.</p>
+                    </div>
+                    <span class="arrow">
+                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                            <path d="M5 12h14M13 6l6 6-6 6" />
+                        </svg>
+                    </span>
+                </a>
+                <a class="card mini" href="https://lunora.sh/packages">
+                    <div class="mc">
+                        <span class="ic">
+                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7">
+                                <path d="M12 2 3 7v10l9 5 9-5V7z" />
+                                <path d="M3 7l9 5 9-5M12 12v10" />
+                            </svg>
+                        </span>
+                        <h3>Cloudflare ecosystem</h3>
+                        <p>Auth, mail, storage, AI, payments — one deploy.</p>
+                    </div>
+                    <span class="arrow">
+                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                            <path d="M5 12h14M13 6l6 6-6 6" />
+                        </svg>
+                    </span>
+                </a>
+            </div>
+        </div>
+
+        <div class="lw-foot">Running on Lunora · Vite + Svelte</div>
+    </div>
+</div>
+`;
+const VANILLA_MAIN = `import "./style.css";
+
+import { LunoraClient } from "lunorash/client";
+
+import { api } from "#lunora/_generated/api.js";
+
+// \`@lunora/vite\` runs the Worker on the same origin as Vite, so default to
+// \`location.origin\`. Point \`VITE_LUNORA_URL\` at a deployed Worker to develop
+// the client against production data.
+const url = (import.meta.env.VITE_LUNORA_URL as string | undefined) ?? globalThis.location.origin;
+const client = new LunoraClient({ url });
+
+const MOON_ICON = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><path d="M21 12.8A9 9 0 1 1 11.2 3a7 7 0 0 0 9.8 9.8z" /></svg>';
+const SUN_ICON =
+    '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><circle cx="12" cy="12" r="4" /><path d="M12 2v2M12 20v2M4 12H2M22 12h-2M5 5l1.5 1.5M17.5 17.5 19 19M19 5l-1.5 1.5M6.5 17.5 5 19" /></svg>';
+
+const welcomeHtml = \`
+    <div class="lw-bg">
+        <div class="arc a1"></div>
+        <div class="arc a2"></div>
+        <div class="glow"></div>
+    </div>
+
+    <button class="lw-toggle" type="button" aria-label="Toggle color theme"></button>
+
+    <div class="lw-wrap">
+        <div class="brand">
+            <svg viewBox="0 0 543 446" role="img" aria-label="Lunora">
+                <path d="${LOGO_PATH}" fill="currentColor" fill-rule="evenodd" />
+            </svg>
+            <span class="word">Lunora</span>
+        </div>
+
+        <div class="grid">
+            <a class="card feature" href="https://lunora.sh/docs">
+                <div class="shot" aria-hidden="true">
+                    <div class="top">
+                        <span class="wm"><i></i> Lunora</span>
+                        <span class="search"></span>
+                        <span class="ver">v0.1</span>
+                    </div>
+                    <div class="body">
+                        <div class="nav">
+                            <i style="width: 80%"></i>
+                            <i style="width: 60%"></i>
+                            <i style="width: 72%"></i>
+                            <i style="width: 50%"></i>
+                            <i style="width: 66%"></i>
+                            <i style="width: 44%"></i>
+                            <i style="width: 58%"></i>
+                        </div>
+                        <div class="doc">
+                            <span class="h"></span>
+                            <i style="width: 92%"></i>
+                            <i style="width: 88%"></i>
+                            <span class="accent"></span>
+                            <i style="width: 80%"></i>
+                            <i style="width: 90%"></i>
+                            <i style="width: 72%"></i>
+                            <i style="width: 84%"></i>
+                            <i style="width: 78%"></i>
+                        </div>
+                    </div>
+                </div>
+                <div class="info">
+                    <span class="ic">
+                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7">
+                            <path d="M4 5a2 2 0 0 1 2-2h9l5 5v11a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2z" />
+                            <path d="M14 3v5h5" />
+                        </svg>
+                    </span>
+                    <h2>Documentation</h2>
+                    <div class="row">
+                        <p>
+                            Schemas, queries, live subscriptions, sharding, and edge deploy — start to finish. New here or coming from Convex or tRPC,
+                            you'll have a live app fast.
+                        </p>
+                        <span class="arrow">
+                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                                <path d="M5 12h14M13 6l6 6-6 6" />
+                            </svg>
+                        </span>
+                    </div>
+                </div>
+            </a>
+
+            <div class="stack">
+                <a class="card mini" href="https://lunora.sh/blog">
+                    <div class="mc">
+                        <span class="ic">
+                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7">
+                                <path d="M5 4h11a1 1 0 0 1 1 1v14a1 1 0 0 1-1 1H6a2 2 0 0 1-2-2V5a1 1 0 0 1 1-1zM8 8h7M8 12h7M8 16h4" />
+                            </svg>
+                        </span>
+                        <h3>Blog</h3>
+                        <p>Product updates, deep dives, and what's new in Lunora.</p>
+                    </div>
+                    <span class="arrow">
+                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                            <path d="M5 12h14M13 6l6 6-6 6" />
+                        </svg>
+                    </span>
+                </a>
+                <a class="card mini" href="/_lunora">
+                    <div class="mc">
+                        <span class="ic">
+                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7">
+                                <rect x="3" y="3" width="18" height="18" rx="1" />
+                                <path d="M3 9h18M9 21V9" />
+                            </svg>
+                        </span>
+                        <h3>Lunora Studio</h3>
+                        <p>Local admin for schema, data, logs, and advisors.</p>
+                    </div>
+                    <span class="arrow">
+                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                            <path d="M5 12h14M13 6l6 6-6 6" />
+                        </svg>
+                    </span>
+                </a>
+                <a class="card mini" href="https://lunora.sh/packages">
+                    <div class="mc">
+                        <span class="ic">
+                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7">
+                                <path d="M12 2 3 7v10l9 5 9-5V7z" />
+                                <path d="M3 7l9 5 9-5M12 12v10" />
+                            </svg>
+                        </span>
+                        <h3>Cloudflare ecosystem</h3>
+                        <p>Auth, mail, storage, AI, payments — one deploy.</p>
+                    </div>
+                    <span class="arrow">
+                        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                            <path d="M5 12h14M13 6l6 6-6 6" />
+                        </svg>
+                    </span>
+                </a>
+            </div>
+        </div>
+
+        <div class="lw-foot">Running on Lunora · Vite + Vanilla · <span id="lw-count">0</span> messages</div>
+    </div>
+\`;
+
+const root = document.querySelector<HTMLDivElement>("#app")!;
+root.classList.add("lunora-welcome");
+root.innerHTML = welcomeHtml;
+
+// Theme toggle: flip the root's data-theme + swap the button's icon/label.
+const toggleButton = root.querySelector<HTMLButtonElement>(".lw-toggle")!;
+
+const paintToggle = (theme: "dark" | "light"): void => {
+    root.dataset.theme = theme;
+    toggleButton.innerHTML = \`\${theme === "light" ? MOON_ICON : SUN_ICON}<span>\${theme === "light" ? "Ivory" : "Night"}</span>\`;
+};
+
+paintToggle(window.matchMedia("(prefers-color-scheme: light)").matches ? "light" : "dark");
+toggleButton.addEventListener("click", () => {
+    paintToggle(root.dataset.theme === "light" ? "dark" : "light");
+});
+
+// Live demo: the message count of a demo channel re-renders on every delta.
+const count = document.querySelector<HTMLSpanElement>("#lw-count")!;
+
+client.onUpdate(api.messages.list, { channelId: "channel:demo" }, (result) => {
+    count.textContent = String(result.messages.length);
+});
+`;
 
 const READ_URL = `const url = (import.meta.env.VITE_LUNORA_URL as string | undefined) ?? globalThis.location.origin;`;
 const REACT_MAIN = `import "./index.css";
@@ -413,51 +1426,103 @@ const app = mount(Root, { target: document.getElementById("app")! });
 
 export default app;
 `;
-const VANILLA_MAIN = `import "./style.css";
-
-import { LunoraClient } from "lunorash/client";
-
-import { api } from "../lunora/_generated/api";
-
-// Vanilla starter: no framework provider — talk to Lunora through the client
-// directly. \`@lunora/vite\` runs the Worker on the same origin as Vite.
-${READ_URL}
-const client = new LunoraClient({ url });
-
-const root = document.querySelector<HTMLDivElement>("#app")!;
-
-const heading = document.createElement("h1");
-heading.textContent = "Vite + Lunora";
-
-const output = document.createElement("pre");
-root.replaceChildren(heading, output);
-
-const render = (messages: unknown): void => {
-    // textContent (not innerHTML) — never inject server data as markup.
-    output.textContent = JSON.stringify(messages, null, 2);
-};
-
-// Live subscription: the list re-renders on every server delta.
-client.onUpdate(api.messages.list, { channelId: "channel:demo" }, render);
-`;
 const ADAPTERS = {
-  react: { adapter: "@lunora/react", createViteTemplate: "react-ts", files: [{ contents: REACT_MAIN, path: "src/main.tsx" }], label: "React" },
-  solid: { adapter: "@lunora/solid", createViteTemplate: "solid", files: [{ contents: SOLID_INDEX, path: "src/index.tsx" }], label: "Solid" },
+  react: {
+    adapter: "@lunora/react",
+    createViteTemplate: "react-ts",
+    files: [
+      { contents: REACT_MAIN, path: "src/main.tsx" },
+      { contents: REACT_APP, path: "src/App.tsx" },
+      { contents: WELCOME_CSS, path: "src/index.css" }
+    ],
+    label: "React"
+  },
+  solid: {
+    adapter: "@lunora/solid",
+    createViteTemplate: "solid-ts",
+    files: [
+      { contents: SOLID_INDEX, path: "src/index.tsx" },
+      { contents: SOLID_APP, path: "src/App.tsx" },
+      { contents: WELCOME_CSS, path: "src/index.css" }
+    ],
+    label: "Solid"
+  },
   svelte: {
     adapter: "@lunora/svelte",
     createViteTemplate: "svelte-ts",
     files: [
       { contents: SVELTE_ROOT, path: "src/Root.svelte" },
-      { contents: SVELTE_MAIN, path: "src/main.ts" }
+      { contents: SVELTE_MAIN, path: "src/main.ts" },
+      { contents: SVELTE_APP, path: "src/App.svelte" },
+      { contents: WELCOME_CSS, path: "src/app.css" }
     ],
     label: "Svelte"
   },
-  vanilla: { adapter: "lunorash/client", createViteTemplate: "vanilla-ts", files: [{ contents: VANILLA_MAIN, path: "src/main.ts" }], label: "Vanilla" },
-  vue: { adapter: "@lunora/vue", createViteTemplate: "vue-ts", files: [{ contents: VUE_MAIN, path: "src/main.ts" }], label: "Vue" }
+  vanilla: {
+    adapter: "lunorash/client",
+    createViteTemplate: "vanilla-ts",
+    files: [
+      { contents: VANILLA_MAIN, path: "src/main.ts" },
+      { contents: WELCOME_CSS, path: "src/style.css" }
+    ],
+    label: "Vanilla"
+  },
+  vue: {
+    adapter: "@lunora/vue",
+    createViteTemplate: "vue-ts",
+    files: [
+      { contents: VUE_MAIN, path: "src/main.ts" },
+      { contents: VUE_APP, path: "src/App.vue" },
+      { contents: WELCOME_CSS, path: "src/style.css" }
+    ],
+    label: "Vue"
+  }
 };
 const isOverlayFramework = (value) => Object.hasOwn(ADAPTERS, value);
 
-const LUNORA_SCHEMA = `import { defineSchema, defineTable, v } from "lunorash/server";
+const RATELIMIT_SCHEMA = `import type { Middleware } from "lunorash/server";
+import { defineSchemaExtension, defineTable, definePlugin, v } from "lunorash/server";
+import { createDbStore, RateLimiter } from "lunorash/ratelimit";
+import type { RateLimitConfigMap } from "lunorash/ratelimit";
+
+export const limits = {
+    default: { kind: "token bucket", period: 60_000, rate: 10 },
+} as const satisfies RateLimitConfigMap;
+
+export type LimitName = keyof typeof limits;
+
+export const makeRateLimiter = (ctx: { db: unknown }): RateLimiter<LimitName> =>
+    new RateLimiter<LimitName>({
+        config: limits,
+        store: createDbStore({ db: ctx.db as never, table: "ratelimit_buckets" }),
+    });
+
+const middleware: Middleware<{ api?: Record<string, unknown>; db: unknown }, { api: Record<string, unknown>; db: unknown }> = ({ ctx, next }) =>
+    next({
+        ctx: {
+            ...ctx,
+            api: { ...ctx.api, ratelimit: makeRateLimiter(ctx) },
+        },
+    });
+
+export const ratelimit = definePlugin("ratelimit", {
+    extension: defineSchemaExtension("ratelimit", {
+        tables: {
+            buckets: defineTable({
+                key: v.string(),
+                value: v.number(),
+                ts: v.number(),
+                prev: v.optional(v.number()),
+            })
+                .index("by_key", ["key"])
+                .externallyManaged(),
+        },
+    }),
+    middleware,
+});
+`;
+const LUNORA_SCHEMA = `import { ratelimit } from "./ratelimit/schema.js";
+import { defineSchema, defineTable, v } from "lunorash/server";
 
 export default defineSchema({
     messages: defineTable({
@@ -466,17 +1531,36 @@ export default defineSchema({
     })
         .shardBy("channelId")
         .index("by_channel", ["channelId"]),
-});
+}).extend(ratelimit.extension);
 `;
-const LUNORA_MESSAGES = `import { mutation, query, v } from "./_generated/server.js";
+const LUNORA_MESSAGES = `import { RateLimiter, rateLimit, createDbStore } from "lunorash/ratelimit";
+
+import { mutation, query, v } from "#lunora/_generated/server.js";
 
-export const list = query.input({ channelId: v.string(), limit: v.optional(v.number()) }).query(async ({ args }) => {
-    return { channelId: args.channelId, limit: args.limit ?? 50, messages: [] };
+const limiter = (ctx: { db: unknown }) => new RateLimiter({
+    config: {
+        send: { kind: "token bucket", period: 60_000, rate: 30 },
+    },
+    store: createDbStore({ db: ctx.db as never, table: "ratelimit_buckets" }),
 });
 
-export const send = mutation.input({ channelId: v.string(), text: v.string() }).mutation(async ({ args }) => {
-    return { channelId: args.channelId, text: args.text };
+export const list = query.input({ channelId: v.string().meta({ schema: { maxLength: 256 } }), limit: v.optional(v.number()) }).query(async ({ args, ctx }) => {
+    const messages = await ctx.db
+        .query("messages")
+        .withIndex("by_channel", (q) => q.eq("channelId", args.channelId))
+        .take(args.limit ?? 50);
+
+    return { channelId: args.channelId, messages };
 });
+
+export const send = mutation
+    .input({ channelId: v.string().meta({ schema: { maxLength: 256 } }), text: v.string().meta({ schema: { maxLength: 4096 } }) })
+    .use(rateLimit(limiter, "send", { key: (ctx) => ctx.auth.userId ?? "anon" }))
+    .mutation(async ({ args, ctx }) => {
+        const id = await ctx.db.insert("messages", { channelId: args.channelId, text: args.text });
+
+        return { channelId: args.channelId, id, text: args.text };
+    });
 `;
 const SERVER_ENTRY = `import type { ShardNamespaceLike } from "lunorash/runtime";
 
@@ -537,15 +1621,17 @@ const ensureGitignore = (target) => {
 ${missing.join("\n")}
 `, "utf8");
 };
-const stampRange = (name, range, distTag) => name === "lunorash" || name.startsWith("@lunora/") ? distTag : range;
+const isLunoraDep$1 = (name) => name === "lunorash" || name.startsWith("@lunora/");
+const stampRange = (name, range, distTag, versions) => isLunoraDep$1(name) ? versions?.get(name) ?? distTag : range;
 const withDependency = (map, name, range, distTag) => {
   return { ...map, [name]: stampRange(name, range, distTag) };
 };
-const restampLunora = (map, distTag) => Object.fromEntries(Object.entries(map).map(([name, range]) => [name, stampRange(name, range, distTag)]));
-const patchPackageJson = (target, name, adapter, distTag) => {
+const restampLunora = (map, distTag, versions) => Object.fromEntries(Object.entries(map).map(([name, range]) => [name, stampRange(name, range, distTag, versions)]));
+const patchPackageJson = async (target, name, adapter, distTag) => {
   const path = join$1(target, "package.json");
   const parsed = JSON.parse(readFileSync(path, "utf8"));
   let dependencies = withDependency(parsed.dependencies ?? {}, "lunorash", distTag, distTag);
+  dependencies = withDependency(dependencies, "@lunora/ratelimit", distTag, distTag);
   if (adapter.adapter.startsWith("@lunora/")) {
     dependencies = withDependency(dependencies, adapter.adapter, distTag, distTag);
   }
@@ -553,12 +1639,16 @@ const patchPackageJson = (target, name, adapter, distTag) => {
     dependencies = withDependency(dependencies, depName, range, distTag);
   }
   let devDependencies = withDependency(parsed.devDependencies ?? {}, "@lunora/vite", distTag, distTag);
+  devDependencies = withDependency(devDependencies, "@lunora/studio", distTag, distTag);
   for (const [depName, range] of Object.entries(COMMON_DEV_DEPENDENCIES)) {
     devDependencies = withDependency(devDependencies, depName, range, distTag);
   }
+  const lunoraNames = [...Object.keys(dependencies), ...Object.keys(devDependencies)].filter((depName) => isLunoraDep$1(depName));
+  const versions = await resolveTagVersions(lunoraNames, distTag);
   parsed.name = name;
-  parsed.dependencies = restampLunora(dependencies, distTag);
-  parsed.devDependencies = restampLunora(devDependencies, distTag);
+  parsed.imports = { ...parsed.imports, "#lunora/*": "./lunora/*" };
+  parsed.dependencies = restampLunora(dependencies, distTag, versions);
+  parsed.devDependencies = restampLunora(devDependencies, distTag, versions);
   parsed.scripts = { ...parsed.scripts, codegen: "lunora codegen", deploy: "vite build && lunora deploy" };
   writeFileSync(path, `${JSON.stringify(parsed, void 0, 4)}
 `, "utf8");
@@ -574,9 +1664,10 @@ const patchBaseViteConfig = (target, logger) => {
     writeFileSync(candidate, result.code, "utf8");
   }
 };
-const applyLunoraOverlay = (options) => {
+const applyLunoraOverlay = async (options) => {
   const { adapter, distTag, logger, name, target } = options;
   const written = [];
+  writeFile(target, join$1("lunora", "ratelimit", "schema.ts"), RATELIMIT_SCHEMA, written);
   writeFile(target, join$1("lunora", "schema.ts"), LUNORA_SCHEMA, written);
   writeFile(target, join$1("lunora", "messages.ts"), LUNORA_MESSAGES, written);
   writeFile(target, join$1("src", "server.ts"), SERVER_ENTRY, written);
@@ -586,11 +1677,111 @@ const applyLunoraOverlay = (options) => {
     writeFile(target, file.path, file.contents, written);
   }
   patchBaseViteConfig(target, logger);
-  patchPackageJson(target, name, adapter, distTag);
+  await patchPackageJson(target, name, adapter, distTag);
   ensureGitignore(target);
   return written;
 };
 
+const ADJECTIVES = [
+  "lunar",
+  "silver",
+  "silent",
+  "waning",
+  "waxing",
+  "crescent",
+  "cosmic",
+  "stellar",
+  "orbital",
+  "gibbous",
+  "twilight",
+  "midnight",
+  "shimmering",
+  "drifting",
+  "weightless"
+];
+const NOUNS = [
+  "moon",
+  "tide",
+  "crater",
+  "comet",
+  "eclipse",
+  "halo",
+  "orbit",
+  "nebula",
+  "voyager",
+  "lander",
+  "rover",
+  "beacon",
+  "harbor",
+  "meadow",
+  "fox"
+];
+const pick = (items) => (
+  // eslint-disable-next-line sonarjs/pseudo-random -- cosmetic default project name, not a security decision.
+  items[Math.floor(Math.random() * items.length)]
+);
+const generateProjectName = () => `${pick(ADJECTIVES)}-${pick(NOUNS)}`;
+
+const isOnline = async () => dns.lookup("github.com").then(
+  () => true,
+  () => false
+);
+const GITHUB_SOURCE = /^(?:gh|github):([^/]+)\/([^#/]+)(?:\/[^#]*)?(?:#(.+))?$/;
+const parseGitHubSource = (source) => {
+  const match = GITHUB_SOURCE.exec(source);
+  if (match === null) {
+    return void 0;
+  }
+  const [, owner, repo, ref] = match;
+  if (owner === void 0 || repo === void 0) {
+    return void 0;
+  }
+  return { owner, ref: ref ?? "HEAD", repo };
+};
+const templateRefExists = async (source) => {
+  const parsed = parseGitHubSource(source);
+  if (parsed === void 0) {
+    return void 0;
+  }
+  const url = `https://codeload.github.com/${parsed.owner}/${parsed.repo}/tar.gz/${parsed.ref}`;
+  try {
+    const response = await fetch(url, { method: "HEAD" });
+    if (response.status === 404) {
+      return false;
+    }
+    return response.ok ? true : void 0;
+  } catch {
+    return void 0;
+  }
+};
+const verifyRemoteTemplate = async (params) => {
+  if (params.isLocal) {
+    return true;
+  }
+  const isGitHubBacked = params.source === void 0 || parseGitHubSource(params.source) !== void 0;
+  if (!isGitHubBacked) {
+    return true;
+  }
+  if (!await isOnline()) {
+    params.logger.error("you appear to be offline — connect to the internet and try again, or scaffold from a local template with `--from <dir>`.");
+    return false;
+  }
+  if (params.source !== void 0 && await templateRefExists(params.source) === false) {
+    params.logger.error(`template source not found: ${params.source} — double-check --ref / --source, or browse the templates at https://lunora.sh/docs.`);
+    return false;
+  }
+  return true;
+};
+
+const COPY = {
+  extras: "Let's finish setting up your app.",
+  framework: "Which framework should we launch?",
+  git: "Initialize a new git repository? (optional)",
+  install: "Install dependencies now?",
+  name: "Where should we land your project?",
+  nextHeader: "Liftoff confirmed — explore your project!",
+  packageManager: "Which package manager?"
+};
 const TEXT_EXTENSIONS = /* @__PURE__ */ new Set([".gitignore", ".html", ".js", ".json", ".jsonc", ".md", ".mjs", ".ts", ".tsx"]);
 const VITE_CONFIG_CANDIDATES = ["vite.config.ts", "vite.config.mts", "vite.config.js", "vite.config.mjs"];
 const MINIMAL_VITE_CONFIG = `import { defineConfig } from "vite";
@@ -633,7 +1824,27 @@ const isTextFile = (filePath) => {
 };
 const substitute = (content, name) => content.replaceAll("{{name}}", name);
 const isLunoraDep = (name) => name === "lunorash" || name.startsWith("@lunora/");
-const stampLunoraDeps = (packageJsonText, distTag) => {
+const resolveLunoraVersions = async (files, distTag) => {
+  const names = /* @__PURE__ */ new Set();
+  for (const file of files) {
+    if (basename(file) !== "package.json") {
+      continue;
+    }
+    try {
+      const parsed = JSON.parse(readFileSync(file, "utf8"));
+      for (const section of ["dependencies", "devDependencies"]) {
+        for (const name of Object.keys(parsed[section] ?? {})) {
+          if (isLunoraDep(name)) {
+            names.add(name);
+          }
+        }
+      }
+    } catch {
+    }
+  }
+  return resolveTagVersions(names, distTag);
+};
+const stampLunoraDeps = (packageJsonText, distTag, versions) => {
   let parsed;
   try {
     parsed = JSON.parse(packageJsonText);
@@ -646,23 +1857,50 @@ const stampLunoraDeps = (packageJsonText, distTag) => {
       if (!isLunoraDep(name)) {
         continue;
       }
-      const edits = modify(text, [section, name], distTag, { formattingOptions: { insertSpaces: true, tabSize: 4 } });
+      const pin = versions.get(name) ?? distTag;
+      const edits = modify(text, [section, name], pin, { formattingOptions: { insertSpaces: true, tabSize: 4 } });
       text = applyEdits(text, edits);
     }
   }
   return text;
 };
+const PNPM_BUILT_DEPENDENCIES = [
+  "@parcel/watcher",
+  "esbuild",
+  "lmdb",
+  "msgpackr-extract",
+  "rs-module-lexer",
+  "sharp",
+  "unrs-resolver",
+  "workerd"
+];
+const PNPM_DENIED_BUILD_DEPENDENCIES = ["cpu-features", "protobufjs", "ssh2"];
+const PNPM_WORKSPACE_FILENAME = "pnpm-workspace.yaml";
+const pnpmWorkspaceYaml = () => [
+  "# pnpm reads its settings from here (the package.json `pnpm` field is no longer read).",
+  "# Pre-approve the toolchain's native build scripts so `pnpm install` runs them",
+  "# without the interactive `pnpm approve-builds` step; deny the optional native",
+  "# builds a scaffold doesn't need (so no C/C++ toolchain is required).",
+  "allowBuilds:",
+  ...PNPM_BUILT_DEPENDENCIES.map((name) => `    '${name}': true`),
+  ...PNPM_DENIED_BUILD_DEPENDENCIES.map((name) => `    '${name}': false`),
+  ""
+].join("\n");
 const collectFiles = (directory) => {
   const out = [];
   for (const entry of walkSync(directory, { includeDirs: false, includeFiles: true })) {
+    if (lstatSync(entry.path).isSymbolicLink()) {
+      continue;
+    }
     out.push(entry.path);
   }
   return out;
 };
-const copyTemplate = (sourceDirectory, target, name) => {
+const copyTemplate = async (sourceDirectory, target, name) => {
   const files = collectFiles(sourceDirectory);
   const written = [];
   const distTag = resolveDistTag();
+  const versions = await resolveLunoraVersions(files, distTag);
   for (const source of files) {
     const relativePath = relative(sourceDirectory, source);
     const destination = join$1(target, relativePath);
@@ -670,7 +1908,7 @@ const copyTemplate = (sourceDirectory, target, name) => {
     const raw = readFileSync(source);
     let text = isTextFile(source) ? substitute(raw.toString("utf8"), name) : void 0;
     if (text !== void 0 && basename(source) === "package.json") {
-      text = stampLunoraDeps(text, distTag);
+      text = stampLunoraDeps(text, distTag, versions);
     }
     if (text === void 0) {
       writeFileSync(destination, raw);
@@ -693,68 +1931,152 @@ const isSafeSource = (source) => {
   }
   return source.startsWith("gh:") || source.startsWith("github:") || source.startsWith("https://");
 };
+const logWould = (logger, action) => {
+  logger.info(`[dry-run] would ${action}`);
+};
 const logScaffoldSuccess = (logger, written, target) => {
+  if (isInteractive()) {
+    process.stdout.write("\n");
+  }
   logger.success(`scaffolded ${String(written.length)} files into ${target}`);
 };
-const runScriptCommand = (manager, script) => {
-  if (manager === "npm") {
-    return `npm run ${script}`;
+const installCommand = (manager, packages) => {
+  const verb = manager === "npm" ? "install" : "add";
+  return `${manager} ${verb} ${packages.join(" ")}`;
+};
+const isInsideMonorepo = (startDirectory) => {
+  let directory = resolve(startDirectory);
+  for (; ; ) {
+    if (existsSync(join$1(directory, "pnpm-workspace.yaml"))) {
+      return true;
+    }
+    const packagePath = join$1(directory, "package.json");
+    if (existsSync(packagePath)) {
+      try {
+        const parsed = JSON.parse(readFileSync(packagePath, "utf8"));
+        if (parsed.workspaces !== void 0) {
+          return true;
+        }
+      } catch {
+      }
+    }
+    const parent = dirname$1(directory);
+    if (parent === directory) {
+      return false;
+    }
+    directory = parent;
+  }
+};
+const isInsideGitRepo = (startDirectory) => {
+  let directory = resolve(startDirectory);
+  for (; ; ) {
+    if (existsSync(join$1(directory, ".git"))) {
+      return true;
+    }
+    const parent = dirname$1(directory);
+    if (parent === directory) {
+      return false;
+    }
+    directory = parent;
+  }
+};
+const maybeOfferGit = async (options, target) => {
+  if (options.yes === true || !isInteractive() || isInsideGitRepo(dirname$1(target))) {
+    return;
   }
-  if (manager === "bun") {
-    return `bun run ${script}`;
+  if (!await tuiConfirm(COPY.git, { badge: BADGES.git, defaultYes: false })) {
+    await tuiInfo("Sounds good! You can always run git init manually.");
+    return;
+  }
+  if (options.dryRun === true) {
+    logWould(options.logger, "initialize a git repository");
+    return;
+  }
+  const spawner = options.spawner ?? defaultSpawner;
+  const result = await withTuiSpinner("Initializing a git repository…", () => spawner({ args: ["init"], command: "git", cwd: target }));
+  if (result.code === 0) {
+    await emitStep("git", "Initialized an empty git repository.");
+  } else {
+    options.logger.warn("`git init` failed — initialize it yourself later with `git init`.");
   }
-  return `${manager} ${script}`;
 };
-const printNextSteps = (logger, name, installed) => {
-  const manager = installed ?? "pnpm";
-  logger.info("next steps:");
-  logger.info(`  cd ${name}`);
+const printNextSteps = async (name, installed, manager, insideMonorepo) => {
+  const steps = [{ code: `cd ./${name}`, lead: "Enter your project directory using" }];
   if (installed === void 0) {
-    logger.info(`  ${manager} install`);
+    steps.push({ code: `${manager} install`, lead: "Install dependencies with", tail: insideMonorepo ? " from the workspace root" : void 0 });
+  }
+  steps.push(
+    { code: runScriptCommand(manager, "dev"), lead: "Run", tail: " to start the dev server." },
+    { code: "lunora add", lead: "Add features like auth or storage using" }
+  );
+  const help = [
+    { code: "https://lunora.sh/docs", lead: "Read the docs at" },
+    { code: "https://lunora.sh/chat", lead: "Stuck? Join the chat at" }
+  ];
+  if (isInteractive()) {
+    await tuiNextSteps(BADGES.next, COPY.nextHeader, steps, help);
+    return;
   }
-  logger.info(`  ${runScriptCommand(manager, "dev")}`);
+  const lines = steps.map((step) => `${step.lead} ${step.code}${step.tail ?? ""}`);
+  lines.push("", ...help.map((line) => `${line.lead} ${line.code}${line.tail ?? ""}`));
+  await emitStep("next", COPY.nextHeader, lines.join("\n"));
 };
 const offerInstallIsInteractive = (options) => options.yes !== true && (options.installPrompt !== void 0 || isInteractive());
 const maybeOfferInstall = async (options, target) => {
   if (!offerInstallIsInteractive(options)) {
     return void 0;
   }
+  if (isInsideMonorepo(dirname$1(target))) {
+    return void 0;
+  }
   const managers = detectInstalledManagers(options.packageManagerProbe);
   const [defaultManager] = managers;
   if (defaultManager === void 0) {
     return void 0;
   }
-  const confirm = options.installPrompt?.confirmInstall ?? (async () => tuiConfirm("Install dependencies now?", { defaultYes: true }));
+  const confirm = options.installPrompt?.confirmInstall ?? (async () => tuiConfirm(COPY.install, { badge: BADGES.deps, defaultYes: true }));
   if (!await confirm()) {
+    await tuiInfo("No problem! Remember to install dependencies after setup.");
     return void 0;
   }
   let manager = defaultManager;
   if (managers.length > 1) {
     manager = options.installPrompt ? await options.installPrompt.selectManager(managers) : await tuiSelect(
-      "Which package manager?",
+      COPY.packageManager,
       managers.map((candidate) => {
         return { label: candidate, value: candidate };
       }),
-      { default: defaultManager }
+      { badge: BADGES.deps, default: defaultManager }
     ) ?? defaultManager;
   }
+  if (options.dryRun === true) {
+    logWould(options.logger, `install dependencies with ${manager}`);
+    return void 0;
+  }
+  if (manager === "pnpm") {
+    const workspacePath = join$1(target, PNPM_WORKSPACE_FILENAME);
+    if (!existsSync(workspacePath)) {
+      writeFileSync(workspacePath, pnpmWorkspaceYaml(), "utf8");
+    }
+  }
   const spawner = options.spawner ?? defaultSpawner;
   const { args, command } = installArgsFor(manager);
-  const result = await withTuiSpinner(`Installing dependencies with ${manager}…`, () => spawner({ args, command, cwd: target }));
+  await emitStep("deps", `Installing dependencies with ${manager}…`);
+  const result = await spawner({ args, command, cwd: target });
   if (result.code !== 0) {
     options.logger.warn(`\`${command} install\` exited with code ${String(result.code)} — run it yourself in ${basename(target)}/.`);
     return void 0;
   }
-  options.logger.success(`installed dependencies with ${manager}`);
+  await emitStep("deps", `Dependencies installed with ${manager}.`);
   return manager;
 };
-const scaffoldFromLocal = (fromRoot, templateType, target, name, logger) => {
+const scaffoldFromLocal = async (fromRoot, templateType, target, name, logger) => {
   const templateDirectory = join$1(fromRoot, templateType);
   if (!existsSync(templateDirectory)) {
     logger.error(`template not found in local source: ${templateDirectory}`);
     return { code: 1, files: [], target };
   }
-  const written = copyTemplate(templateDirectory, target, name);
+  const written = await copyTemplate(templateDirectory, target, name);
   logScaffoldSuccess(logger, written, target);
   return { code: 0, files: written, target };
 };
@@ -763,30 +2085,55 @@ const scaffoldFromRemote = async (options) => {
   const stagingRoot = mkdtempSync(join$1(tmpdir(), "lunora-init-fetch-"));
   const stagingDirectory = join$1(stagingRoot, "template");
   try {
-    const remote = resolveTemplateSource(templateType, source, ref);
-    const downloaded = await withTuiSpinner(
-      `Fetching the ${templateType} template…`,
-      () => downloadTemplate(remote, {
-        cwd: stagingRoot,
-        dir: stagingDirectory,
-        force: true,
-        install: false,
-        silent: true
-      })
+    const pinnedRef = source !== void 0 && source.length > 0 ? ref : await resolvePinnedSourceRef(ref, logger);
+    const remote = resolveTemplateSource(templateType, source, pinnedRef);
+    let downloaded;
+    let written = [];
+    await tuiTasks(
+      [
+        {
+          label: `${templateType} template fetched`,
+          run: async () => {
+            downloaded = await downloadTemplate(remote, {
+              cwd: stagingRoot,
+              dir: stagingDirectory,
+              force: true,
+              install: false,
+              silent: true
+            });
+          }
+        },
+        {
+          label: `files copied into ${name}/`,
+          run: async () => {
+            written = await copyTemplate(stagingDirectory, target, name);
+          }
+        }
+      ],
+      { end: "Project initialized!", start: "Project initializing…" }
     );
     const staged = collectFiles(stagingDirectory);
+    if (isInteractive()) {
+      process.stdout.write("\n");
+    }
     logger.info(
-      downloaded.commit ? `template: ${downloaded.source} @ ${downloaded.commit} (${String(staged.length)} files)` : `template: ${downloaded.source} (${String(staged.length)} files)`
-    );
-    const written = await withTuiSpinner(
-      `Scaffolding ${String(staged.length)} files into ${name}/…`,
-      () => Promise.resolve(copyTemplate(stagingDirectory, target, name))
+      downloaded?.commit ? `template: ${downloaded.source} @ ${downloaded.commit} (${String(staged.length)} files)` : `template: ${downloaded?.source ?? remote} (${String(staged.length)} files)`
     );
     logScaffoldSuccess(logger, written, target);
     return { code: 0, files: written, target };
   } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    logger.error(`failed to download template: ${message}`);
+    if (error instanceof PromptCancelledError) {
+      throw error;
+    }
+    const { hints, message } = describeDownloadFailure(error, {
+      ref: resolveSourceRef(ref),
+      remote: resolveTemplateSource(templateType, source, ref),
+      templateType
+    });
+    logger.error(message);
+    for (const hint of hints) {
+      logger.warn(hint);
+    }
     return { code: 1, files: [], target };
   } finally {
     rmSync(stagingRoot, { force: true, recursive: true });
@@ -805,30 +2152,44 @@ const scaffoldViteOverlay = async (options) => {
   const adapter = ADAPTERS[framework];
   const stagingRoot = mkdtempSync(join$1(tmpdir(), "lunora-vite-base-"));
   try {
-    if (overlayBaseFrom === void 0) {
-      const stagingDirectory = join$1(stagingRoot, "base");
-      const remote = `github:vitejs/vite/packages/create-vite/template-${adapter.createViteTemplate}#main`;
-      await withTuiSpinner(
-        `Fetching the ${adapter.label} (create-vite) base…`,
-        () => downloadTemplate(remote, { cwd: stagingRoot, dir: stagingDirectory, force: true, install: false, silent: true })
-      );
-      renameCreateViteDotfiles(stagingDirectory);
-      cpSync(stagingDirectory, target, { recursive: true });
-    } else {
-      const localBase = join$1(overlayBaseFrom, `template-${adapter.createViteTemplate}`);
+    let localBase;
+    if (overlayBaseFrom !== void 0) {
+      localBase = join$1(overlayBaseFrom, `template-${adapter.createViteTemplate}`);
       if (!existsSync(localBase)) {
         logger.error(`create-vite base not found on disk: ${localBase}`);
         return { code: 1, files: [], target };
       }
-      cpSync(localBase, target, { recursive: true });
     }
-    const written = await withTuiSpinner(
-      `Applying the Lunora overlay (${adapter.label})…`,
-      () => Promise.resolve(applyLunoraOverlay({ adapter, distTag: resolveDistTag(), logger, name, target }))
+    const copyBase = async () => {
+      if (localBase !== void 0) {
+        cpSync(localBase, target, { recursive: true });
+        return;
+      }
+      const stagingDirectory = join$1(stagingRoot, "base");
+      const remote = `github:vitejs/vite/packages/create-vite/template-${adapter.createViteTemplate}#main`;
+      await downloadTemplate(remote, { cwd: stagingRoot, dir: stagingDirectory, force: true, install: false, silent: true });
+      renameCreateViteDotfiles(stagingDirectory);
+      cpSync(stagingDirectory, target, { recursive: true });
+    };
+    let written = [];
+    await tuiTasks(
+      [
+        { label: `create-vite (${adapter.label}) base ready`, run: copyBase },
+        {
+          label: `Lunora overlay applied (${adapter.label})`,
+          run: async () => {
+            written = await applyLunoraOverlay({ adapter, distTag: resolveDistTag(), logger, name, target });
+          }
+        }
+      ],
+      { end: "Project initialized!", start: "Project initializing…" }
     );
     logScaffoldSuccess(logger, written, target);
     return { code: 0, files: [...collectFiles(target)], target };
   } catch (error) {
+    if (error instanceof PromptCancelledError) {
+      throw error;
+    }
     const message = error instanceof Error ? error.message : String(error);
     logger.error(`failed to scaffold the ${adapter.label} base: ${message}`);
     return { code: 1, files: [], target };
@@ -896,12 +2257,12 @@ const scaffoldLunoraDirectory = (cwd, logger) => {
   }
   return written;
 };
-const printFrameworkNextSteps = (detection, logger) => {
+const printFrameworkNextSteps = (detection, manager, logger) => {
   const { adapter, class: frameworkClass, framework } = detection;
   logger.info("");
   logger.info(`detected framework: ${framework} (class ${frameworkClass})`);
   logger.info("next steps:");
-  logger.info(`  1. install the adapter:  pnpm add ${adapter} @lunora/client @lunora/runtime @lunora/server`);
+  logger.info(`  1. install the adapter:  ${installCommand(manager, [adapter, "@lunora/client", "@lunora/runtime", "@lunora/server"])}`);
   logger.info("  2. run codegen:          lunora codegen");
   if (frameworkClass === "A") {
     logger.info("  3. compose one worker:   wrap your worker entry with");
@@ -947,51 +2308,77 @@ const runInPlaceInit = (cwd, logger) => {
     return viteResult;
   }
   const scaffolded = scaffoldLunoraDirectory(cwd, logger);
-  printFrameworkNextSteps(detection, logger);
+  printFrameworkNextSteps(detection, detectPackageManager(cwd), logger);
   return { code: 0, files: [...viteResult.files, ...scaffolded], target: cwd };
 };
 const offerIsInteractive = (options) => options.yes !== true && (options.prompt !== void 0 || (options.interactive ?? isInteractive()));
 const maybeOfferExtras = async (options, projectDirectory) => {
   const interactive = offerIsInteractive(options);
-  const apply = async (names, applyOptions) => {
+  const preselected = options.add === void 0 ? [] : parseFeatureList(options.add, (message) => {
+    options.logger.warn(message);
+  });
+  const applyAll = async (plans) => {
+    if (plans.length === 0) {
+      return true;
+    }
+    if (options.dryRun === true) {
+      logWould(options.logger, `add ${plans.map((plan) => plan.label).join(", ")}`);
+      return true;
+    }
+    const buffered = [];
     const applyLogger = isInteractive() ? {
       error: (message) => {
-        options.logger.error(message);
+        buffered.push({ level: "error", message });
       },
       info: () => {
       },
       success: () => {
       },
       warn: (message) => {
-        options.logger.warn(message);
+        buffered.push({ level: "warn", message });
       }
     } : options.logger;
-    const result = await withTuiSpinner(
-      `adding ${names.join(", ")}…`,
-      () => runAddCommand({
-        allowUnsafeSource: options.allowUnsafeSource,
-        cwd: projectDirectory,
-        from: options.registryFrom,
-        logger: applyLogger,
-        names: [...names],
-        ref: options.ref,
-        source: options.registrySource,
-        transformManifest: applyOptions?.transformManifest,
-        yes: true
-      })
-    );
-    return result.code === 0;
+    const steps = plans.map((plan) => {
+      return {
+        running: `adding ${plan.label}…`,
+        task: () => runAddCommand({
+          allowUnsafeSource: options.allowUnsafeSource,
+          cwd: projectDirectory,
+          from: options.registryFrom,
+          logger: applyLogger,
+          names: [...plan.names],
+          ref: options.ref,
+          source: options.registrySource,
+          transformManifest: plan.transformManifest,
+          yes: true
+        })
+      };
+    });
+    const done = `added ${plans.map((plan) => plan.label).join(", ")}`;
+    const results = await withTuiBadgeProgress(BADGES.add, steps, done);
+    for (const { level, message } of buffered) {
+      options.logger[level](message);
+    }
+    return results.every((result) => result.code === 0);
   };
-  await tuiIntro("let's finish setting up your app");
-  await offerRegistryExtras({
-    apply,
+  const deps = {
+    applyAll,
     interactive,
     logger: options.logger,
-    multiSelect: options.prompt?.multiSelect ?? ((message, choices, settings) => tuiMultiSelect(message, choices, settings)),
+    multiSelect: options.prompt?.multiSelect ?? ((message, choices, settings) => tuiMultiSelect(message, choices, { ...settings, badge: BADGES.add })),
+    preselected: preselected.length > 0 ? preselected : void 0,
     projectName: basename(projectDirectory),
-    select: options.prompt?.select ?? ((message, choices, settings) => tuiSelect(message, choices, settings)),
-    text: options.prompt?.text ?? ((message, settings) => tuiText(message, settings))
-  });
+    select: options.prompt?.select ?? ((message, choices, settings) => tuiSelect(message, choices, { ...settings, badge: BADGES.add })),
+    text: options.prompt?.text ?? ((message, settings) => tuiText(message, { ...settings, badge: BADGES.add }))
+  };
+  if (preselected.length > 0) {
+    await offerRegistryExtras(deps);
+    return;
+  }
+  if (isInteractive()) {
+    await tuiHeadline(COPY.extras);
+  }
+  await offerRegistryExtras(deps);
 };
 const DEFAULT_FRAMEWORK = "react";
 const FRAMEWORK_CHOICES = [
@@ -999,6 +2386,7 @@ const FRAMEWORK_CHOICES = [
   { description: "Vue SPA — create-vite base + Lunora", label: "Vue", value: "vue" },
   { description: "Solid SPA — create-vite base + Lunora", label: "Solid", value: "solid" },
   { description: "Svelte SPA — create-vite base + Lunora", label: "Svelte", value: "svelte" },
+  { description: "Next.js (App Router) — OpenNext on Cloudflare + a standalone Lunora worker", label: "Next.js", value: "next" },
   { description: "TanStack Start (React) — SSR with live-loader routes", label: "TanStack Start · React", value: "tanstack-start-react" },
   { description: "TanStack Start (Solid)", label: "TanStack Start · Solid", value: "tanstack-start-solid" },
   { description: "React Router (v7, framework mode) — SSR composed into the Lunora worker", label: "React Router", value: "react-router" },
@@ -1006,6 +2394,7 @@ const FRAMEWORK_CHOICES = [
   { description: "AnalogJS (Angular) — single-worker, Lunora mounted in Nitro", label: "Analog", value: "analog" },
   { description: "Nuxt (Vue) — single-worker, Lunora mounted in Nitro", label: "Nuxt", value: "nuxt" },
   { description: "SvelteKit + a standalone Lunora worker", label: "SvelteKit", value: "sveltekit" },
+  { description: "React Native (Expo) — an iOS/Android/web app + a Lunora worker backend", label: "React Native · Expo", value: "expo" },
   { description: "Worker only — no frontend", label: "Standalone", value: "standalone" }
 ];
 const OVERLAY_VALUES = Object.keys(ADAPTERS).join("|");
@@ -1021,7 +2410,7 @@ const resolveScaffoldChoice = async (options) => {
   if (!isInteractive() || options.yes === true) {
     return { framework: DEFAULT_FRAMEWORK, kind: "overlay" };
   }
-  return toScaffoldChoice(await tuiSelect("Which framework would you like?", FRAMEWORK_CHOICES, { default: DEFAULT_FRAMEWORK }) ?? DEFAULT_FRAMEWORK);
+  return toScaffoldChoice(await tuiSelect(COPY.framework, FRAMEWORK_CHOICES, { badge: BADGES.tmpl, default: DEFAULT_FRAMEWORK }) ?? DEFAULT_FRAMEWORK);
 };
 const nonInteractiveInitError = (options) => {
   if (isInteractive() || options.yes === true) {
@@ -1039,68 +2428,137 @@ const nonInteractiveInitError = (options) => {
   }
   return `lunora init can't prompt in a non-interactive terminal — provide ${missing.join(" and ")}, or pass --yes to accept the defaults.`;
 };
-const scaffoldNewProject = async (options, cwd) => {
-  await tuiBanner("realtime backend on Cloudflare Workers + Durable Objects");
+const scaffoldOverlayPath = async (options, framework, name, target) => {
+  if (!isOverlayFramework(framework)) {
+    options.logger.error(`init: unknown framework "${framework}". Supported overlays: ${Object.keys(ADAPTERS).join(", ")}.`);
+    return { code: 1, files: [], target };
+  }
+  if (!await verifyRemoteTemplate({ isLocal: options.overlayBaseFrom !== void 0, logger: options.logger })) {
+    return { code: 1, files: [], target };
+  }
+  mkdirSync(target, { recursive: true });
+  return scaffoldViteOverlay({ framework, logger: options.logger, name, overlayBaseFrom: options.overlayBaseFrom, target });
+};
+const scaffoldTemplatePath = async (options, templateType, name, target) => {
+  if (options.from !== void 0) {
+    return await scaffoldFromLocal(options.from, templateType, target, name, options.logger);
+  }
+  if (options.source !== void 0 && options.source.length > 0 && !options.allowUnsafeSource && !isSafeSource(options.source)) {
+    options.logger.error(
+      `init: refusing --source ${options.source} — only gh:, github:, or https:// sources are allowed (and may not contain ".."). Re-run with --allow-unsafe-source if you really want this.`
+    );
+    return { code: 1, files: [], target };
+  }
+  if (!await verifyRemoteTemplate({ isLocal: false, logger: options.logger, source: resolveTemplateSource(templateType, options.source, options.ref) })) {
+    return { code: 1, files: [], target };
+  }
+  return scaffoldFromRemote({ logger: options.logger, name, ref: options.ref, source: options.source, target, templateType });
+};
+const scaffoldNewProject = async (options, cwd, recordTarget) => {
+  await tuiMoonrise("realtime backend on Cloudflare Workers + Durable Objects");
   const blocked = nonInteractiveInitError(options);
   if (blocked !== void 0) {
     options.logger.error(blocked);
     return { code: 1, files: [], target: "" };
   }
-  const name = options.name ?? await tuiText("What should we call your project?", { default: "lunora-app", placeholder: "lunora-app" });
+  const suggestedName = generateProjectName();
+  const rawName = options.name ?? await tuiText(COPY.name, { badge: BADGES.dir, default: suggestedName, placeholder: suggestedName });
   const choice = await resolveScaffoldChoice(options);
+  const name = rawName.trim();
+  if (name.length === 0) {
+    options.logger.error(`init: refusing an empty project name — pass a directory name (e.g. \`lunora init my-app\`).`);
+    return { code: 1, files: [], target: "" };
+  }
   if (name.includes("/") || name.includes("\\") || name === ".." || name === ".") {
     options.logger.error(`init: refusing project name "${name}" — must not contain path separators or be "." / "..".`);
     return { code: 1, files: [], target: "" };
   }
   const target = resolve(cwd, name);
-  if (existsSync(target)) {
+  const targetPreExisted = existsSync(target);
+  if (targetPreExisted) {
     const entries = readdirSync(target);
     if (entries.length > 0) {
       options.logger.error(`target directory not empty: ${target}`);
       return { code: 1, files: [], target };
     }
   }
-  if (choice.kind === "overlay") {
-    if (!isOverlayFramework(choice.framework)) {
-      options.logger.error(`init: unknown framework "${choice.framework}". Supported overlays: ${Object.keys(ADAPTERS).join(", ")}.`);
-      return { code: 1, files: [], target };
+  if (options.dryRun === true) {
+    const what = choice.kind === "overlay" ? `the ${choice.framework} create-vite overlay` : `the ${choice.templateType} template`;
+    logWould(options.logger, `scaffold ${what} into ${target}`);
+    return { code: 0, files: [], target };
+  }
+  recordTarget(target, targetPreExisted);
+  return choice.kind === "overlay" ? scaffoldOverlayPath(options, choice.framework, name, target) : scaffoldTemplatePath(options, choice.templateType, name, target);
+};
+const resetScaffoldOnCancel = (cleanup, logger) => {
+  const { target, targetPreExisted } = cleanup;
+  if (target === void 0 || !existsSync(target)) {
+    return;
+  }
+  if (targetPreExisted === true) {
+    for (const entry of readdirSync(target)) {
+      rmSync(join$1(target, entry), { force: true, recursive: true });
     }
-    mkdirSync(target, { recursive: true });
-    return scaffoldViteOverlay({ framework: choice.framework, logger: options.logger, name, overlayBaseFrom: options.overlayBaseFrom, target });
+  } else {
+    rmSync(target, { force: true, recursive: true });
   }
-  const { templateType } = choice;
-  if (templateType === "next") {
-    options.logger.warn('template "next" is not yet available — re-run with `--vite react` or `-t standalone`.');
-    return { code: 1, files: [], target };
+  logger.info(`removed the partially-created project at ${target}`);
+};
+const runScaffoldStep = async (options, cwd, recordTarget) => {
+  if (options.inPlace !== true) {
+    return scaffoldNewProject(options, cwd, recordTarget);
   }
-  if (options.from !== void 0) {
-    return scaffoldFromLocal(options.from, templateType, target, name, options.logger);
+  if (options.dryRun === true) {
+    logWould(options.logger, `configure Lunora into ${cwd}`);
+    return { code: 0, files: [], target: cwd };
   }
-  if (options.source !== void 0 && options.source.length > 0 && !options.allowUnsafeSource && !isSafeSource(options.source)) {
-    options.logger.error(
-      `init: refusing --source ${options.source} — only gh:, github:, or https:// sources are allowed (and may not contain ".."). Re-run with --allow-unsafe-source if you really want this.`
-    );
-    return { code: 1, files: [], target };
+  return runInPlaceInit(cwd, options.logger);
+};
+const runPostScaffold = async (options, result, cwd) => {
+  await maybeOfferExtras(options, result.target);
+  const installedManager = options.inPlace === true ? void 0 : await maybeOfferInstall(options, result.target);
+  if (options.inPlace !== true) {
+    await maybeOfferGit(options, result.target);
+    const manager = installedManager ?? detectPackageManager(result.target);
+    await printNextSteps(basename(result.target), installedManager, manager, isInsideMonorepo(cwd));
+    await emitMascot(options.logger);
   }
-  return scaffoldFromRemote({ logger: options.logger, name, ref: options.ref, source: options.source, target, templateType });
+};
+const scaffoldCiPipeline = (options, result, cwd) => {
+  if (result.code !== 0 || options.ci === void 0) {
+    return;
+  }
+  if (options.dryRun === true) {
+    logWould(options.logger, `scaffold a ${options.ci} CI deploy pipeline`);
+    return;
+  }
+  scaffoldCiWorkflow(options.inPlace === true ? cwd : result.target, options.ci, options.logger);
 };
 const runInitCommand = async (options) => {
   const cwd = options.cwd ?? process.cwd();
-  const result = options.inPlace === true ? runInPlaceInit(cwd, options.logger) : await scaffoldNewProject(options, cwd);
-  if (result.code === 0 && result.target !== "") {
-    await maybeOfferExtras(options, result.target);
-    const installedManager = options.inPlace === true ? void 0 : await maybeOfferInstall(options, result.target);
-    if (options.inPlace !== true) {
-      await tuiOutro("you're all set 🎉");
-      printNextSteps(options.logger, basename(result.target), installedManager);
+  const cleanup = {};
+  let result;
+  try {
+    result = await runScaffoldStep(options, cwd, (target, preExisted) => {
+      cleanup.target = target;
+      cleanup.targetPreExisted = preExisted;
+    });
+    if (result.code === 0 && result.target !== "") {
+      cleanup.target = void 0;
+      await runPostScaffold(options, result, cwd);
     }
+  } catch (error) {
+    if (error instanceof PromptCancelledError) {
+      resetScaffoldOnCancel(cleanup, options.logger);
+      process.stdout.write("\n  ✖  Setup cancelled — run `lunora init` again whenever you're ready. 🌙\n");
+      return { code: 130, files: [], target: "" };
+    }
+    throw error;
   }
-  if (result.code === 0 && options.ci !== void 0) {
-    scaffoldCiWorkflow(options.inPlace === true ? cwd : result.target, options.ci, options.logger);
-  }
+  scaffoldCiPipeline(options, result, cwd);
   return result;
 };
-const isTemplate = (value) => value === "analog" || value === "astro" || value === "next" || value === "nuxt" || value === "react-router" || value === "standalone" || value === "sveltekit" || value === "tanstack-start-react" || value === "tanstack-start-solid";
+const isTemplate = (value) => value === "analog" || value === "astro" || value === "expo" || value === "next" || value === "nuxt" || value === "react-router" || value === "standalone" || value === "sveltekit" || value === "tanstack-start-react" || value === "tanstack-start-solid";
 const resolveCiProvider = (raw, logger) => {
   if (raw === void 0) {
     return void 0;
@@ -1114,9 +2572,11 @@ const resolveCiProvider = (raw, logger) => {
 const execute = defineHandler(({ argument, cwd, logger, options }) => {
   const templateType = options.template !== void 0 && isTemplate(options.template) ? options.template : void 0;
   return runInitCommand({
+    add: options.add,
     allowUnsafeSource: options.allowUnsafeSource === true,
     cwd,
     ci: resolveCiProvider(options.ci, logger),
+    dryRun: options.dryRun === true,
     from: options.from,
     inPlace: options.here === true,
     interactive: options.interactive === true ? true : void 0,