@lunora/cli 1.0.0-alpha.10 → 1.0.0-alpha.101

package/dist/packem_chunks/runInitCommand.mjs

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync, rmSync, mkdtempSync, cpSync, 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, LUNA_ART, LUNA_NAME, LUNA_SIGNOFF, paintAnswer, BADGES } from '@lunora/config';
 import { walkSync } from '@visulima/fs';
@@ -6,15 +6,16 @@ import { join as join$1, dirname as dirname$1, basename, resolve, relative } fro
 import { downloadTemplate } from 'giget';
 import { modify, applyEdits } from 'jsonc-parser';
 import { join, dirname } from 'node:path';
-import { d as defineHandler } from '../packem_shared/command-BC30oSBW.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 resolveSourceRef, d as resolveDistTag, r as runAddCommand } from '../packem_shared/commands-DPKWlqqX.mjs';
-import { defaultSpawner } from '../packem_shared/createRecordingSpawner-DxI3mebw.mjs';
-import { d as tuiMascot, e as tuiStep, P as PromptCancelledError, f as tuiMoonrise, t as tuiText, g as tuiHeadline, h as tuiInfo, a as tuiSelect, w as withTuiSpinner, b as tuiConfirm, i as tuiNextSteps, j as tuiTasks, k as tuiMultiSelect, l as withTuiBadgeProgress } from '../packem_shared/tui-prompts-DEiPCKV-.mjs';
-import { logStep } from '../packem_shared/createLogger-B40gPzQo.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-2RJBhUC4.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
@@ -287,6 +288,36 @@ 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);
@@ -312,13 +343,20 @@ ${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 STACK_FEATURE_VALUES = STACK_FEATURE_OPTIONS.map((option) => option.value);
 const featureItem = (feature) => feature === "email" ? EMAIL_ITEM : feature;
@@ -370,7 +408,10 @@ const offerRegistryExtras = async (deps) => {
     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: [] });
@@ -385,6 +426,920 @@ const offerRegistryExtras = async (deps) => {
   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";
 
@@ -471,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({
@@ -524,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";
 
@@ -595,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);
   }
@@ -611,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");
@@ -632,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);
@@ -644,7 +1677,7 @@ 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;
 };
@@ -791,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);
@@ -804,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);
@@ -828,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);
@@ -860,14 +1940,9 @@ const logScaffoldSuccess = (logger, written, target) => {
   }
   logger.success(`scaffolded ${String(written.length)} files into ${target}`);
 };
-const runScriptCommand = (manager, script) => {
-  if (manager === "npm") {
-    return `npm run ${script}`;
-  }
-  if (manager === "bun") {
-    return `bun run ${script}`;
-  }
-  return `${manager} ${script}`;
+const installCommand = (manager, packages) => {
+  const verb = manager === "npm" ? "install" : "add";
+  return `${manager} ${verb} ${packages.join(" ")}`;
 };
 const isInsideMonorepo = (startDirectory) => {
   let directory = resolve(startDirectory);
@@ -925,8 +2000,7 @@ const maybeOfferGit = async (options, target) => {
     options.logger.warn("`git init` failed — initialize it yourself later with `git init`.");
   }
 };
-const printNextSteps = async (name, installed, insideMonorepo) => {
-  const manager = installed ?? "pnpm";
+const printNextSteps = async (name, installed, manager, insideMonorepo) => {
   const steps = [{ code: `cd ./${name}`, lead: "Enter your project directory using" }];
   if (installed === void 0) {
     steps.push({ code: `${manager} install`, lead: "Install dependencies with", tail: insideMonorepo ? " from the workspace root" : void 0 });
@@ -979,9 +2053,16 @@ const maybeOfferInstall = async (options, target) => {
     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;
@@ -989,13 +2070,13 @@ const maybeOfferInstall = async (options, target) => {
   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 };
 };
@@ -1004,7 +2085,8 @@ 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 pinnedRef = source !== void 0 && source.length > 0 ? ref : await resolvePinnedSourceRef(ref, logger);
+    const remote = resolveTemplateSource(templateType, source, pinnedRef);
     let downloaded;
     let written = [];
     await tuiTasks(
@@ -1023,9 +2105,8 @@ const scaffoldFromRemote = async (options) => {
         },
         {
           label: `files copied into ${name}/`,
-          run: () => {
-            written = copyTemplate(stagingDirectory, target, name);
-            return Promise.resolve();
+          run: async () => {
+            written = await copyTemplate(stagingDirectory, target, name);
           }
         }
       ],
@@ -1044,8 +2125,15 @@ const scaffoldFromRemote = async (options) => {
     if (error instanceof PromptCancelledError) {
       throw error;
     }
-    const message = error instanceof Error ? error.message : String(error);
-    logger.error(`failed to download template: ${message}`);
+    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 });
@@ -1089,9 +2177,8 @@ const scaffoldViteOverlay = async (options) => {
         { label: `create-vite (${adapter.label}) base ready`, run: copyBase },
         {
           label: `Lunora overlay applied (${adapter.label})`,
-          run: () => {
-            written = applyLunoraOverlay({ adapter, distTag: resolveDistTag(), logger, name, target });
-            return Promise.resolve();
+          run: async () => {
+            written = await applyLunoraOverlay({ adapter, distTag: resolveDistTag(), logger, name, target });
           }
         }
       ],
@@ -1170,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");
@@ -1221,7 +2308,7 @@ 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()));
@@ -1238,16 +2325,17 @@ const maybeOfferExtras = async (options, projectDirectory) => {
       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 steps = plans.map((plan) => {
@@ -1268,6 +2356,9 @@ const maybeOfferExtras = async (options, projectDirectory) => {
     });
     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);
   };
   const deps = {
@@ -1295,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" },
@@ -1302,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("|");
@@ -1347,12 +2440,8 @@ const scaffoldOverlayPath = async (options, framework, name, target) => {
   return scaffoldViteOverlay({ framework, logger: options.logger, name, overlayBaseFrom: options.overlayBaseFrom, target });
 };
 const scaffoldTemplatePath = async (options, templateType, name, target) => {
-  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 };
-  }
   if (options.from !== void 0) {
-    return scaffoldFromLocal(options.from, templateType, target, name, options.logger);
+    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(
@@ -1373,8 +2462,13 @@ const scaffoldNewProject = async (options, cwd, recordTarget) => {
     return { code: 1, files: [], target: "" };
   }
   const suggestedName = generateProjectName();
-  const name = options.name ?? await tuiText(COPY.name, { badge: BADGES.dir, default: suggestedName, placeholder: suggestedName });
+  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: "" };
@@ -1425,7 +2519,8 @@ const runPostScaffold = async (options, result, cwd) => {
   const installedManager = options.inPlace === true ? void 0 : await maybeOfferInstall(options, result.target);
   if (options.inPlace !== true) {
     await maybeOfferGit(options, result.target);
-    await printNextSteps(basename(result.target), installedManager, isInsideMonorepo(cwd));
+    const manager = installedManager ?? detectPackageManager(result.target);
+    await printNextSteps(basename(result.target), installedManager, manager, isInsideMonorepo(cwd));
     await emitMascot(options.logger);
   }
 };
@@ -1463,7 +2558,7 @@ const runInitCommand = async (options) => {
   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;