@lunora/cli
Version:
The Lunora CLI: init, dev, deploy, codegen, migrate, seed, doctor, insights, logs, registry, and the rest of the project commands
1,257 lines • 95.9 kB
JavaScript
import{existsSync as m,mkdirSync as L,writeFileSync as g,readFileSync as x,readdirSync as ie,rmSync as R,lstatSync as le,mkdtempSync as ce,copyFileSync as Ke,renameSync as qe}from"node:fs";import{tmpdir as de}from"node:os";import{installArgsFor as ue,execArgsFor as Ge,detectFramework as Ye,isInteractive as v,LUNA_ART as Je,LUNA_NAME as Xe,LUNA_SIGNOFF as Qe,BADGES as f,paintAnswer as Ze,detectPackageManager as H,detectInstalledManagers as et,runScriptCommand as tt,detectLintTools as rt,addArgsFor as at,applyLintIgnores as ot}from"@lunora/config";import{walkSync as nt}from"@visulima/fs";import{join as p,dirname as M,basename as N,resolve as pe,relative as he}from"@visulima/path";import{downloadTemplate as me}from"giget";import{modify as st,applyEdits as it}from"jsonc-parser";import{join as z,dirname as lt}from"node:path";import{d as ct}from"../packem_shared/command-DwC11Cwe.mjs";import dt from"magic-string";import{Project as ut,SyntaxKind as w}from"ts-morph";import{P as K}from"../packem_shared/prompt-cancelled-C8Sj7OqI.mjs";import{l as fe,m as pt,n as ge,o as ve,b as ht}from"../packem_shared/resolve-B9ReA3FV.mjs";import{defaultSpawner as we}from"../packem_shared/createRecordingSpawner-DJlNacZ6.mjs";import{d as mt,e as ft,f as gt,a as ye,t as q,g as be,h as vt,b as xe,i as ke,w as wt,j as yt,k as Ce,l as bt}from"../packem_shared/tui-prompts-DzYd2fL3.mjs";import{A as Se,E as Le,p as xt,w as kt,M as Ct,r as St,k as Lt,e as Mt,c as Me,l as Ae,i as At,f as Et}from"../packem_shared/storage-B0ixDDxG.mjs";import{logStep as J}from"../packem_shared/createLogger-hGafwf-3.mjs";import{r as Nt}from"../packem_shared/lint-ignore-report-DKZagpqk.mjs";import _t from"node:dns/promises";import{r as It}from"../packem_shared/commands-I18aR_DJ.mjs";const G={bun:{githubCacheKey:void 0,githubSetupStep:` - uses: oven-sh/setup-bun@v2
`,gitlabImage:"oven/bun:1",gitlabProvisionScript:[],installCmd:"bun install --frozen-lockfile",lockfile:"bun.lockb"},npm:{githubCacheKey:"npm",githubSetupStep:"",gitlabImage:"node:22",gitlabProvisionScript:[],installCmd:"npm ci",lockfile:"package-lock.json"},pnpm:{githubCacheKey:"pnpm",githubSetupStep:` - uses: pnpm/action-setup@v4
with:
version: latest
`,gitlabImage:"node:22",gitlabProvisionScript:["corepack enable"],installCmd:"pnpm install --frozen-lockfile",lockfile:"pnpm-lock.yaml"},yarn:{githubCacheKey:"yarn",githubSetupStep:"",gitlabImage:"node:22",gitlabProvisionScript:["corepack enable"],installCmd:"yarn install --frozen-lockfile",lockfile:"yarn.lock"}},S=(e,t)=>{const r=Ge(e,"lunora",t);return[r.command,...r.args].join(" ")},X=e=>` - uses: actions/checkout@v4
${e.githubSetupStep} - uses: actions/setup-node@v4
with:
node-version: 22
${e.githubCacheKey===void 0?"":` cache: ${e.githubCacheKey}
`} - run: ${e.installCmd}`,$t=e=>{const t=G[e],r=t.githubCacheKey===void 0?`# (below) requires it — run \`${e} install\` locally and`:`# (below) and the ${e} cache both require it — run \`${e} install\` locally and`;return`name: Deploy
on:
push:
branches: [main]
pull_request:
workflow_dispatch:
# Prerequisite: commit your ${t.lockfile}. \`${t.installCmd}\`
${r}
# commit the lockfile before pushing, or the first CI run fails.
#
# Set these repository secrets (Settings → Secrets and variables → Actions):
# CLOUDFLARE_API_TOKEN — a Workers-scoped API token
# CLOUDFLARE_ACCOUNT_ID — your Cloudflare account id
env:
CLOUDFLARE_API_TOKEN: \${{ secrets.CLOUDFLARE_API_TOKEN }}
CLOUDFLARE_ACCOUNT_ID: \${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
jobs:
# Production deploy on push to the default branch.
deploy:
if: github.event_name != 'pull_request'
runs-on: ubuntu-latest
permissions:
contents: read
steps:
${X(t)}
# Codegen + wrangler validation gate (no deploy) — fails fast on drift.
- run: ${S(e,["prepare"])}
- run: ${S(e,["deploy"])}
# Preview version on every pull request — uploads a versioned preview URL;
# production traffic is untouched.
preview:
if: github.event_name == 'pull_request'
runs-on: ubuntu-latest
permissions:
contents: read
steps:
${X(t)}
- run: ${S(e,["deploy","--preview"])}
`},Rt=e=>{const t=G[e],r=[...t.gitlabProvisionScript,t.installCmd].map(a=>` - ${a}`).join(`
`);return`stages:
- deploy
# Prerequisite: commit your ${t.lockfile}. \`${t.installCmd}\`
# (below) requires it — run \`${e} install\` locally and commit the lockfile
# before pushing, or the first pipeline fails.
#
# Set these as masked CI/CD variables (Settings → CI/CD → Variables):
# CLOUDFLARE_API_TOKEN — a Workers-scoped API token
# CLOUDFLARE_ACCOUNT_ID — your Cloudflare account id
.lunora_base:
image: ${t.gitlabImage}
stage: deploy
before_script:
${r}
# Production deploy on the default branch.
deploy:
extends: .lunora_base
rules:
- if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
script:
# Codegen + wrangler validation gate (no deploy) — fails fast on drift.
- ${S(e,["prepare"])}
- ${S(e,["deploy"])}
# Preview version on every merge request (versioned preview URL; production
# traffic is untouched).
preview:
extends: .lunora_base
rules:
- if: $CI_PIPELINE_SOURCE == "merge_request_event"
script:
- ${S(e,["deploy","--preview"])}
`},Ee={github:{file:z(".github","workflows","deploy.yml"),secretsHint:"repository secrets (Settings → Secrets and variables → Actions)"},gitlab:{file:".gitlab-ci.yml",secretsHint:"masked CI/CD variables (Settings → CI/CD → Variables)"}},Tt=(e,t)=>e==="github"?$t(t):Rt(t),Ot=e=>e==="github"||e==="gitlab",Pt=(e,t,r,a={})=>{const o=z(e,Ee[t].file);return m(o)&&a.overwrite!==!0?{path:o,skipped:!0,written:!1}:(L(lt(o),{recursive:!0}),g(o,Tt(t,r),"utf8"),{path:o,skipped:!1,written:!0})},Dt=(e,t,r,a,o={})=>{const n=Ee[t];try{const s=Pt(e,t,r,o);if(s.skipped)a.info(`--ci ${t}: ${n.file} already exists — left unchanged (re-run with overwrite to replace).`);else{const i=ue(r),l=[i.command,...i.args].join(" "),{installCmd:c,lockfile:d}=G[r];a.success(`--ci ${t}: wrote ${n.file}`),a.info(`--ci ${t}: set CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID as ${n.secretsHint} to enable deploys.`),a.info(`--ci ${t}: run \`${l}\` and commit ${d} before pushing — the pipeline runs \`${c}\`.`)}return s}catch(s){const i=s instanceof Error?s.message:String(s);return a.warn(`--ci ${t}: could not write ${n.file} (${i})`),{path:z(e,n.file),skipped:!1,written:!1}}},Bt={astro:"@lunora/react",none:"@lunora/react",nuxt:"@lunora/vue","react-router":"@lunora/react","solid-start":"@lunora/solid",sveltekit:"@lunora/svelte","tanstack-start":"@lunora/react","tanstack-start-solid":"@lunora/solid",vinext:"@lunora/react"},jt=e=>{const t=Ye(e);return{...t,adapter:Bt[t.framework]}},$="lunora()",Q='import { lunora } from "@lunora/vite";',Vt=/\blunora\s*\(/u,Ut='"@lunora/vite"',Ft="'@lunora/vite'",Wt=e=>{for(const t of e.getStatements()){if(t.getKind()!==w.ExportAssignment)continue;const r=t.asKindOrThrow(w.ExportAssignment).getExpression();if(r.getKind()!==w.CallExpression)continue;const a=r.asKindOrThrow(w.CallExpression);if(a.getExpression().getText()!=="defineConfig")continue;const o=a.getArguments()[0];if(o?.getKind()===w.ObjectLiteralExpression)return o.asKindOrThrow(w.ObjectLiteralExpression)}},Ht=e=>{for(const t of e.getStatements()){if(t.getKind()!==w.ExportAssignment)continue;const r=t.asKindOrThrow(w.ExportAssignment).getExpression();if(r.getKind()===w.ObjectLiteralExpression)return r.asKindOrThrow(w.ObjectLiteralExpression)}},zt=e=>new ut({compilerOptions:{allowJs:!0},useInMemoryFileSystem:!0}).createSourceFile("vite.config.ts",e,{overwrite:!0}),Kt=(e,t)=>{const r=t.getImportDeclarations().at(-1)?.getEnd()??0;r===0?e.prepend(`${Q}
`):e.appendLeft(r,`
${Q}`)},qt=(e,t)=>{const r=t.getProperty("plugins");if(r===void 0){const s=t.getProperties(),i=t.getStart()+1;if(s.length===0){e.appendLeft(i,` plugins: [${$}] `);return}const l=s[0];if(l===void 0)return"could not locate the start of the Vite config object's first property";e.appendLeft(l.getStart(),`plugins: [${$}],
`);return}const a=r.getDescendantsOfKind(w.ArrayLiteralExpression)[0];if(a===void 0)return"the Vite config's `plugins` is not an array literal — add `lunora()` to it by hand";const o=a.getElements();if(o.length===0){e.appendLeft(a.getStart()+1,$);return}const n=o[0];if(n===void 0)return"could not locate the first entry of the Vite config's `plugins` array";e.appendLeft(n.getStart(),`${$}, `)},Ne=e=>{if(Vt.test(e))return{changed:!1,code:e,reason:"lunora plugin already present"};const t=zt(e),r=Wt(t)??Ht(t);if(r===void 0)return{changed:!1,code:e,reason:"could not locate a Vite config plugins array to patch"};const a=new dt(e);!e.includes(Ut)&&!e.includes(Ft)&&Kt(a,t);const o=qt(a,r);return o!==void 0?{changed:!1,code:e,reason:o}:{changed:!0,code:a.toString()}},Gt=/enotfound|eai_again|econnrefused|etimedout|network|fetch failed|getaddrinfo/u,Yt=/404|not found|could not find|no such/u,Jt=(e,t)=>{const r=e instanceof Error?e.message:String(e),a=r.toLowerCase(),o=`failed to download template "${t.templateType}" from ${t.remote}: ${r}`;return Yt.test(a)?{hints:[`Check the template name "${t.templateType}" and the ref "${t.ref}".`,"List/inspect available templates, or target a branch/tag with `--ref <branch>`."],message:`template "${t.templateType}" not found at ${t.remote}: ${r}`}:Gt.test(a)?{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:o}:{hints:["If this is a network/offline issue, scaffold from a local root with `lunora init --from <dir>`."],message:o}},T=async(e,t,r)=>{if(v()){await ft(f[e],t,r);return}if(process.stdout.write(`
`),r===void 0||r===""){J(e,t);return}const a=r.split(`
`).map(o=>Ze(o)).join(`
`);J(e,`${t}
${a}`)},Xt=async e=>{if(v()){await mt();return}e.info(`
${Je}
${Xe}: ${Qe}`)},_e=[{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:"Copy-in auth screens for your framework (sign in/up, reset, 2FA)",label:"Auth UI",value:"auth-ui"},{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:"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"}],Z=_e.map(e=>e.value),Qt=e=>e==="email"?Le:e,Zt=(e,t)=>{const r=[];for(const a of e.split(",").map(o=>o.trim()).filter(Boolean))Z.includes(a)?r.includes(a)||r.push(a):t(`init: unknown --add feature "${a}" — expected ${Z.join(" | ")}; skipping.`);return r},Ie=e=>e.resolveAuthUiItem===void 0?"auth-ui-react":e.resolveAuthUiItem(),er=async e=>{const t=await Mt(e.select),r=await Me(e.text,e.projectName);return{label:"auth",names:[t],transformManifest:a=>Ae(a,r)}},tr=async e=>{const t=await e.text(Ct,{placeholder:"you@yourdomain.com"}),r=St(t,a=>{e.logger.warn(a)});return{label:"email",names:[Le],transformManifest:r===void 0?void 0:a=>Lt(a,r)}},rr=async(e,t)=>{const r=Ie(e);if(r===void 0){e.logger.error(`init: ${Se}`);return}if(t)return{label:"auth-ui",names:[r]};const a=await Me(e.text,e.projectName);return{label:"auth-ui",names:[r],transformManifest:o=>Ae(o,a)}},ar=async e=>{const t=await xt(e.text,e.projectName);return{label:"storage",names:["storage"],transformManifest:r=>kt(r,t)}},or=(e,t)=>{const r=[];let a=!1;for(const o of t){if(o!=="auth-ui"){r.push({label:o,names:[Qt(o)]});continue}const n=Ie(e);if(n===void 0){e.logger.error(`init: ${Se}`),a=!0;continue}r.push({label:o,names:[n]})}return{plans:r,refused:a}},nr={auth:er,"auth-ui":async(e,t)=>rr(e,t.includes("auth")),email:tr,storage:ar},ee=async e=>{if(e.preselected!==void 0&&e.preselected.length>0){const{plans:a,refused:o}=or(e,e.preselected);return await e.applyAll(a)&&!o}if(!e.interactive)return e.logger.info("tip: add features later with `lunora add <ai|auth|backup|browser|cloudflare-access|crons|email|flags|hyperdrive|payment|presence|queue|storage|workflow>`."),!0;const t=await e.multiSelect("Which features do you want to add?",_e,{defaults:[]});if(t.length===0)return!0;const r=[];for(const a of t){const o=nr[a],n=o?await o(e,t):{label:a,names:[a]};n!==void 0&&r.push(n)}return await e.applyAll(r),!0},sr=[{description:"Adds an ignores entry to eslint.config.js",label:"ESLint",value:"eslint"},{description:"Writes .prettierignore",label:"Prettier",value:"prettier"},{description:"Adds negated patterns to biome.json",label:"Biome",value:"biome"},{description:"Writes ignorePatterns to .oxlintrc.json",label:"oxlint (oxc)",value:"oxlint"}],ir="Which linter/formatter do you use? We'll tell it to skip Lunora's generated files.",lr=async e=>{const t=e.interactive?await e.multiSelect(ir,sr,{defaults:e.detected}):[...e.detected];if(t.length===0)return[];const r=e.apply(t);return Nt(r,e.logger),r},_="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",E=`/* 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; } }
`,cr=`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="${_}" 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>
);
}
`,dr=`<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="${_}" 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>
`,ur=`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="${_}" 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>
);
}
`,pr=`<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="${_}" 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>
`,hr=`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="${_}" 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.subscribe(api.messages.list, { channelId: "channel:demo" }, (result) => {
count.textContent = String(result.messages.length);
});
`,O="const url = (import.meta.env.VITE_LUNORA_URL as string | undefined) ?? globalThis.location.origin;",mr=`import "./index.css";
import { LunoraProvider } from "@lunora/react";
import { LunoraClient } from "lunorash/client";
import { StrictMode } from "react";
import { createRoot } from "react-dom/client";
import App from "./App.tsx";
// \`@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.
${O}
const client = new LunoraClient({ url });
const root = document.getElementById("root");
if (!root) {
throw new Error("missing #root mount node");
}
createRoot(root).render(
<StrictMode>
<LunoraProvider client={client}>
<App />
</LunoraProvider>
</StrictMode>,
);
`,fr=`import "./style.css";
import { createLunora } from "@lunora/vue";
import { LunoraClient } from "lunorash/client";
import { createApp } from "vue";
import App from "./App.vue";
// Provide one LunoraClient at the app root via the Vue plugin form.
${O}
createApp(App).use(createLunora(new LunoraClient({ url }))).mount("#app");
`,gr=`import "./index.css";
import { LunoraProvider } from "@lunora/solid";
import { LunoraClient } from "lunorash/client";
import { render } from "solid-js/web";
import App from "./App";
${O}
const client = new LunoraClient({ url });
const root = document.getElementById("root");
render(
() => (
<LunoraProvider client={client}>
<App />
</LunoraProvider>
),
root!,
);
`,vr=`<script lang="ts">
import { setLunoraClient } from "@lunora/svelte";
import { LunoraClient } from "lunorash/client";
import App from "./App.svelte";
${O}
setLunoraClient(new LunoraClient({ url }));
<\/script>
<App />
`,wr=`import "./app.css";
import { mount } from "svelte";
import Root from "./Root.svelte";
// Mount \`Root\` (it sets the ambient LunoraClient) rather than \`App\` directly.
const app = mount(Root, { target: document.getElementById("app")! });
export default app;
`,P={react:{adapter:"@lunora/react",createViteTemplate:"react-ts",files:[{contents:mr,path:"src/main.tsx"},{contents:cr,path:"src/App.tsx"},{contents:E,path:"src/index.css"}],label:"React"},solid:{adapter:"@lunora/solid",createViteTemplate:"solid-ts",files:[{contents:gr,path:"src/index.tsx"},{contents:ur,path:"src/App.tsx"},{contents:E,path:"src/index.css"}],label:"Solid"},svelte:{adapter:"@lunora/svelte",createViteTemplate:"svelte-ts",files:[{contents:vr,path:"src/Root.svelte"},{contents:wr,path:"src/main.ts"},{contents:pr,path:"src/App.svelte"},{contents:E,path:"src/app.css"}],label:"Svelte"},vanilla:{adapter:"lunorash/client",createViteTemplate:"vanilla-ts",files:[{contents:hr,path:"src/main.ts"},{contents:E,path:"src/style.css"}],label:"Vanilla"},vue:{adapter:"@lunora/vue",createViteTemplate:"vue-ts",files:[{contents:fr,path:"src/main.ts"},{contents:dr,path:"src/App.vue"},{contents:E,path:"src/style.css"}],label:"Vue"}},D=e=>Object.hasOwn(P,e),yr=`/**
* Rate-limit schema extension + plugin.
*
* Defines the \`ratelimit_buckets\` table used by \`createDbStore\` for durable,
* DO-backed rate limiting. Included automatically in every Lunora project.
*/
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";
/**
* Named limits this app enforces. This is the one place they live — add your own
* and reference them by name from \`rateLimit(limiter, "<name>", …)\` (see
* \`lunora/messages.ts\`).
*/
export const limits = {
/** Chat writes: 30 per caller per minute, refilling continuously over 60s. */
send: { kind: "token bucket", period: 60_000, rate: 30 },
} 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,
});
`,br=`import { ratelimit } from "./ratelimit/schema.js";
import { defineSchema, defineTable, v } from "lunorash/server";
export default defineSchema({
messages: defineTable({
channelId: v.string(),
text: v.string(),
})
.shardBy("channelId")
.index("by_channel", ["channelId"]),
}).extend(ratelimit.extension);
`,xr=`import { rateLimit } from "lunorash/ratelimit";
import { makeRateLimiter } from "./ratelimit/schema.js";
import type { MutationCtx } from "#lunora/_generated/server.js";
import { mutation, query, v } from "#lunora/_generated/server.js";
/**
* The limiter comes from \`lunora/ratelimit/schema.ts\` — that file owns the named
* limits and the durable store, so tuning \`send\` there is what changes this
* procedure's budget. Build it from the generated \`MutationCtx\` so
* \`rateLimit(limiter, …)\` infers the full procedure context: \`ctx.auth\`/\`ctx.ip\`
* in the key callback and a typed \`ctx.db\` in the handler both depend on it.
*/
const limiter = (ctx: MutationCtx) => makeRateLimiter(ctx);
/**
* One bucket per caller, not one bucket for the whole app.
*
* \`ctx.auth.userId\` is \`null\` until you wire auth (\`lunora registry add auth\`),
* so the \`ctx.ip\` fallback is what actually keys the limit in a fresh project —
* Cloudflare's server-side \`CF-Connecting-IP\`, never a client header. Keying on
* \`"anon"\` alone would let one script exhaust the budget for every user.
*/
const byCaller = { key: (ctx: { auth: { userId?: null | string }; ip?: string }): string => ctx.auth.userId ?? ctx.ip ?? "anon" };
export const list = query.input({ channelId: v.string().max(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().max(256), text: v.string().max(4096) })
.use(rateLimit(limiter, "send", byCaller))
.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 };
});
`,kr=`import type { ShardNamespaceLike } from "lunorash/runtime";
import { defineApp } from "../lunora/_generated/app.js";
interface Env extends Record<string, unknown> {
SHARD: ShardNamespaceLike;
}
const app = defineApp<Env>()
.shard((env) => env.SHARD)
.build();
export const ShardDO = app.ShardDO;
export default app;
`,Cr=`{
"$schema": "node_modules/wrangler/config-schema.json",
"name": "__NAME__",
"main": "src/server.ts",
"compatibility_date": "2026-06-10",
"compatibility_flags": ["nodejs_compat"],
"durable_objects": {
"bindings": [{ "name": "SHARD", "class_name": "ShardDO" }],
},
"migrations": [{ "tag": "v1", "new_sqlite_classes": ["ShardDO"] }],
"observability": { "enabled": true, "head_sampling_rate": 1 },
}
`,te=[".wrangler",".env",".env.*","!.env.example",".dev.vars",".dev.vars.*","!.dev.vars.example",".lunora/",".lunora-cache","lunora/_generated"],Sr=`# Lunora endpoint for the browser client.
# Vite statically replaces \`import.meta.env.VITE_LUNORA_URL\` at \`vite dev\` / build.
# Leave it unset to use the page origin; set it to point at a deployed Worker:
#
# VITE_LUNORA_URL=https://my-app.example.workers.dev
`,Lr={"@cloudflare/workers-types":"^4.20260611.1",wrangler:"^4.100.0"},k=(e,t,r,a)=>{const o=p(e,t);L(M(o),{recursive:!0}),g(o,r,"utf8"),a.push(o)},Mr=/\r?\n/,Ar=e=>{const t=p(e,".gitignore"),r=m(t)?x(t,"utf8"):"",a=new Set(r.split(Mr)),o=te.filter(i=>!a.has(i));if(o.length===0)return;const n=o.some(i=>!i.startsWith("!"))?[...o.filter(i=>!i.startsWith("!")),...te.filter(i=>i.startsWith("!"))]:o,s=r.length>0&&!r.endsWith(`
`)?`
`:"";g(t,`${r}${s}
# Lunora
${n.join(`
`)}
`,"utf8")},B=e=>e==="lunorash"||e.startsWith("@lunora/"),Er=(e,t,r,a)=>B(e)?a.get(e)??r:t,C=(e,t,r)=>({...e,[t]:r}),re=(e,t,r)=>Object.fromEntries(Object.entries(e).map(([a,o])=>[a,Er(a,o,t,r)])),Nr=async(e,t,r,a)=>{const o=p(e,"package.json"),n=JSON.parse(x(o,"utf8"));let s=C(n.dependencies??{},"lunorash",a);s=C(s,"@lunora/ratelimit",a),r.adapter.startsWith("@lunora/")&&(s=C(s,r.adapter,a));for(const[d,h]of Object.entries(r.extraDependencies??{}))s=C(s,d,h);let i=C(n.devDependencies??{},"@lunora/vite",a);i=C(i,"@lunora/studio",a);for(const[d,h]of Object.entries(Lr))i=C(i,d,h);const l=[...Object.keys(s),...Object.keys(i)].filter(d=>B(d)),c=await fe(l,a);n.name=t,n.imports={...n.imports,"#lunora/*":"./lunora/*"},n.dependencies=re(s,a,c),n.devDependencies=re(i,a,c),n.scripts={...n.scripts,codegen:"lunora codegen",deploy:"vite build && lunora deploy"},g(o,`${JSON.stringify(n,void 0,4)}
`,"utf8")},_r=["vite.config.ts","vite.config.mts","vite.config.js","vite.config.mjs"],$e=e=>_r.map(t=>p(e,t)).find(t=>m(t)),Ir=(e,t)=>{const r=$e(e);if(r===void 0){t.warn("overlay: no vite.config found in the create-vite base — add `lunora()` to your Vite plugins manually.");return}const a=Ne(x(r,"utf8"));a.changed&&g(r,a.code,"utf8")},$r=async e=>{const{adapter:t,distTag:r,logger:a,name:o,target:n}=e,s=[];k(n,p("lunora","ratelimit","schema.ts"),yr,s),k(n,p("lunora","schema.ts"),br,s),k(n,p("lunora","messages.ts"),xr,s),k(n,p("src","server.ts"),kr,s),k(n,"wrangler.jsonc",Cr.replaceAll("__NAME__",o),s),k(n,".env.example",Sr,s);for(const i of t.files)k(n,i.path,i.contents,s);return Ir(n,a),await Nr(n,o,t,r),Ar(n),s},Rr=["lunar","silver","silent","waning","waxing","crescent","cosmic","stellar","orbital","gibbous","twilight","midnight","shimmering","drifting","weightless"],Tr=["moon","tide","crater","comet","eclipse","halo","orbit","nebula","voyager","lander","rover","beacon","harbor","meadow","fox"],ae=e=>e[Math.floor(Math.random()*e.length)],Or=()=>`${ae(Rr)}-${ae(Tr)}`,Pr=async()=>_t.lookup("github.com").then(()=>!0,()=>!1),Dr=/^(?:gh|github):([^/]+)\/([^#/]+)(?:\/[^#]*)?(?:#(.+))?$/,Re=e=>{const t=Dr.exec(e);if(t===null)return;const[,r,a,o]=t;if(!(r===void 0||a===void 0))return{owner:r,ref:o??"HEAD",repo:a}},Br=async e=>{const t=Re(e);if(t===void 0)return;const r=`https://codeload.github.com/${t.owner}/${t.repo}/tar.gz/${t.ref}`;try{const a=await fetch(r,{method:"HEAD"});return a.status===404?!1:a.ok?!0:void 0}catch{return}},Te=async e=>e.isLocal||!(e.source===void 0||Re(e.source)!==void 0)?!0:await Pr()?e.source!==void 0&&await Br(e.source)===!1?(e.logger.error(`template source not found: ${e.source} — double-check --ref / --source, or browse the templates at https://lunora.sh/docs.`),!1):!0:(e.logger.error("you appear to be offline — connect to the internet and try again, or scaffold from a local template with `--from <dir>`."),!1),b={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?"},jr=new Set([".gitignore",".html",".js",".json",".jsonc",".md",".mjs",".ts",".tsx"]),Vr=`import { defineConfig } from "vite";
import { lunora } from "@lunora/vite";
export default defineConfig({ plugins: [lunora()] });
`,Ur=`import { defineSchema, defineTable, v } from "@lunora/server";
export default defineSchema({
messages: defineTable({
channelId: v.string(),
text: v.string(),
})
.shardBy("channelId")
.index("by_channel", ["channelId"]),
});
`,Fr=`import { mutation, query, v } from "./_generated/server";
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: [] };
});
export const send = mutation
.input({ channelId: v.string(), text: v.string() })
.mutation(async ({ args }) => {
return { channelId: args.channelId, text: args.text };
});
`,Wr="gh:anolilab/lunora/templates",Hr=e=>{const t=e.lastIndexOf(".");return t===-1?!1:jr.has(e.slice(t))},zr=/^[a-z0-9_][a-z0-9\-_]*$/u,Kr=/([a-z0-9])([A-Z])/gu,qr=/[^a-z0-9_]/gu,Gr=e=>{const t=e.replaceAll(Kr,"$1-$2").toLowerCase().replaceAll(qr,"-").split("-").filter(r=>r.length>0);return t.length>0?t.join("-"):"my-app"},Yr=(e,t)=>e.replaceAll("{{name}}",t),Jr=async(e,t)=>{const r=new Set;for(const a of e)if(N(a)==="package.json")try{const o=JSON.parse(x(a,"utf8"));for(const n of["dependencies","devDependencies"])for(const s of Object.keys(o[n]??{}))B(s)&&r.add(s)}catch{}return fe(r,t)},Xr=(e,t,r)=>{let a;try{a=JSON.parse(e)}catch{return e}let o=e;for(const n of["dependencies","devDependencies"])for(const s of Object.keys(a[n]??{})){if(!B(s))continue;const i=r.get(s)??t,l=st(o,[n,s],i,{formattingOptions:{insertSpaces:!0,tabSize:4}});o=it(o,l)}return o},Qr=["@parcel/watcher","esbuild","lmdb","msgpackr-extract","rs-module-lexer","sharp","unrs-resolver","vue-demi","workerd"],Zr=["cpu-features","protobufjs","ssh2"],Oe="pnpm-workspace.yaml",ea=()=>["# 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:",...Qr.map(e=>` '${e}': true`),...Zr.map(e=>` '${e}': false`),""].join(`
`),j=e=>{const t=[];for(const r of nt(e,{includeDirs:!1,includeFiles:!0}))le(r.path).isSymbolicLink()||t.push(r.path);return t},oe="vitejs/vite",ne=(e,t)=>{for(const r of j(e)){const a=p(t,he(e,r));L(M(a),{recursive:!0}),Ke(r,a)}},Pe=async(e,t,r)=>{const a=j(e),o=[],n=ge(),s=await Jr(a,n);for(const i of a){const l=he(e,i),c=p(t,l);L(M(c),{recursive:!0});const d=x(i);let h=Hr(i)?Yr(d.toString("utf8"),r):void 0;h!==void 0&&N(i)==="package.json"&&(h=Xr(h,n,s)),h===void 0?g(c,d):g(c,h,"utf8"),o.push(c)}return o},F=(e,t,r)=>t!==void 0&&t.length>0?t:`${Wr}/${e}#${ve(r)}`,ta=e=>e.includes("..")?!1:e.startsWith("gh:")||e.startsWith("github:")||e.startsWith("https://"),A=(e,t)=>{e.info(`[dry-run] would ${t}`)},De=(e,t,r)=>(e.error(`init: the template at ${r} contains no files — nothing was scaffolded. Check the template name, \`--source\` layout and \`--ref\`.`),{code:1,files:[],target:t}),Be="Template files copied.",Y=(e,t,r)=>{v()&&process.stdout.write(`
`),e.success(`scaffolded ${String(t.length)} files into ${r}`)},ra=(e,t)=>{const{args:r,command:a}=at(e,t);return`${a} ${r.join(" ")}`},je=(e,t)=>{let r=pe(e);for(;;){if(t(r))return!0;const a=M(r);if(a===r)return!1;r=a}},aa=e=>{if(m(p(e,Oe)))return!0;const t=p(e,"package.json");if(!m(t))return!1;try{return JSON.parse(x(t,"utf8")).workspaces!==void 0}catch{return!1}},Ve=e=>je(e,aa),oa=e=>je(e,t=>m(p(t,".git"))),na=async(e,t)=>{if(e.yes===!0||!v()||oa(M(t)))return;if(!await xe(b.git,{badge:f.git,defaultYes:!1})){await ke("Sounds good! You can always run git init manually.");return}if(e.dryRun===!0){A(e.logger,"initialize a git repository");return}const r=e.spawner??we;(await wt("Initializing a git repository…",()=>r({args:["init"],command:"git",cwd:t}))).code===0?await T("git","Initialized an empty git repository."):e.logger.warn("`git init` failed — initialize it yourself later with `git init`.")},sa=async(e,t,r,a)=>{const o=[{code:`cd ./${e}`,lead:"Enter your project directory using"}];t===void 0&&o.push({code:`${r} install`,lead:"Install dependencies with",tail:a?" from the workspace root":void 0}),o.push({code:tt(r,"dev"),lead:"Run",tail:" to start the dev server."},{code:"lunora add",lead:"Add features like auth or storage using"});const n=[{code:"https://lunora.sh/docs",lead:"Read the docs at"},{code:"https://lunora.sh/chat",lead:"Stuck? Join the chat at"}];if(v()){await yt(f.next,b.nextHeader,o,n);return}const s=o.map(i=>`${i.lead} ${i.code}${i.tail??""}`);s.push("",...n.map(i=>`${i.lead} ${i.code}${i.tail??""}`)),await T("next",b.nextHeader,s.join(`
`))},ia=e=>e.yes!==!0&&(e.installPrompt!==void 0||v()),la=async(e,t)=>{if(!ia(e)||Ve(M(t)))return;const r=et(e.packageManagerProbe),[a]=r;if(a===void 0)return;if(!await(e.installPrompt?.confirmInstall??(async()=>xe(b.install,{badge:f.deps,defaultYes:!0})))()){await ke("No problem! Remember to install dependencies after setup.");return}let n=a;if(r.length>1&&(n=e.installPrompt?await e.installPrompt.selectManager(r):await q(b.packageManager,r.map(d=>({label:d,value:d})),{badge:f.deps,default:a})??a),e.dryRun===!0){A(e.logger,`install dependencies with ${n}`);return}if(n==="pnpm"){const d=p(t,Oe);m(d)||g(d,ea(),"utf8")}const s=e.spawner??we,{args:i,command:l}=ue(n);await T("deps",`Installing dependencies with ${n}…`);const c=await s({args:i,command:l,cwd:t});if(c.code!==0){e.logger.warn(`\`${l} install\` exited with code ${String(c.code)} — run it yourself in ${N(t)}/.`);return}return await T("deps",`Dependencies installed with ${n}.`),n},ca=async(e,t,r,a,o,n)=>{const s=p(e,t);if(!m(s))return o.error(`template not found in local source: ${s}`),{code:1,files:[],target:r};const i=await Pe(s,r,a);return i.length===0?De(o,r,s):(n(),Y(o,i,r),{code:0,files:i,target:r})},da=async e=>{const{logger:t,markComplete:r,name:a,ref:o,source:n,target:s,templateType:i}=e,l=ce(p(de(),"lunora-init-fetch-")),c=p(l,"template");try{const d=n!==void 0&&n.length>0?o:await ht(o,t),h=F(i,n,d);let u,y=[];if(await Ce([{label:`${i} template fetched`,run:async()=>{u=await me(h,{cwd:l,dir:c,force:!0,install:!1,silent:!0})}},{label:`files copied into ${a}/`,run:async()=>{y=await Pe(c,s,a)}}],{end:Be,start:"Project initializing…"}),y.length===0)return De(t,s,u?.source??h);r();const I=j(c);return v()&&process.stdout.write(`
`),t.info(u?.commit?`template: ${u.source} @ ${u.commit} (${String(I.length)} files)`:`template: ${u?.source??h} (${String(I.length)} files)`),Y(t,y,s),{code:0,files:y,target:s}}catch(d){if(d instanceof K)throw d;const{hints:h,message:u}=Jt(d,{ref:ve(o),remote:F(i,n,o),templateType:i});t.error(u);for(const y of h)t.warn(y);return{code:1,files:[],target:s}}finally{R(l,{force:!0,recursive:!0})}},ua=e=>{for(const t of["_gitignore","_npmrc","_gitattributes"]){const r=p(e,t);m(r)&&qe(r,p(e,`.${t.slice(1)}`))}},pa=async e=>{const{framework:t,logger:r,markComplete:a,name:o,overlayBaseFrom:n,target:s}=e,i=P[t],l=ce(p(de(),"lunora-vite-base-"));try{let c;if(n!==void 0&&(c=p(n,`template-${i.createViteTemplate}`),!m(c)))return r.error(`create-vite base not found on disk: ${c}`),{code:1,files:[],target:s};const d=async()=>{if(c!==void 0){ne(c,s);return}const u=p(l,"base"),y=await pt(oe,"main",r),I=`github:${oe}/packages/create-vite/template-${i.createViteTemplate}#${y}`;await me(I,{cwd:l,dir:u,force:!0,install:!1,silent:!0}),ua(u),ne(u,s)};let h=[];return await Ce([{label:`create-vite (${i.label}) base ready`,run:d},{label:`Lunora overlay applied (${i.label})`,run:async()=>{h=await $r({adapter:i,distTag:ge(),logger:r,name:o,target:s})}}],{end:Be,start:"Project initializing…"}),a(),Y(r,h,s),{code:0,files:[...j(s)],target:s}}catch(c){if(c instanceof K)throw c;const d=c instanceof Error?c.message:String(c);return r.error(`failed to scaffold the ${i.label} base: ${d}`),{code:1,files:[],target:s}}finally{R(l,{force:!0,recursive:!0})}},W=(e,t,r,a,o)=>(o.error(`init --in-place: could not ${e} ${t}: ${r instanceof Error?r.message:String(r)}`),{code:1,files:[],target:a}),ha=(e,t)=>{const r=p(e,"vite.config.ts");try{g(r,Vr,"utf8")}catch(a){return W("write",r,a,e,t)}return t.success(`created ${r} with lunora() plugin`),{code:0,files:[r],target:e}},ma=(e,t,r)=>{let a;try{a=x(e,"utf8")}catch(n){return W("read",e,n,t,r)}const o=Ne(a);if(!o.changed)return r.info(`${e}: ${o.reason??"no changes needed"}`),{code:0,files:[],target:t};try{g(e,o.code,"utf8")}catch(n){return W("write",e,n,t,r)}return r.success(`patched ${e} — added lunora() plugin`),{code:0,files:[e],target:t}},fa=(e,t)=>{const r=p(e,"lunora"),a=p(r,"schema.ts");if(m(a))return t.info(`lunora/ already present — left ${a} untouched`),[];const o=[];try{L(r,{recursive:!0}),g(a,Ur,"utf8"),o.push(a);const n=p(r,"messages.ts");m(n)||(g(n,Fr,"utf8"),o.push(n)),t.success(`scaffolded lunora/ (${String(o.length)} file(s))`)}catch(n){const s=n instanceof Error?n.message:String(n);t.error(`init --here: could not scaffold lunora/: ${s}`)}return o},Ue=e=>e==="sveltekit"||e==="nuxt"||e==="astro",ga=(e,t,r)=>{const{adapter:a,class:o,framework:n}=e;r.info(""),r.info(`detected framework: ${n} (class ${o})`),r.info("next steps:");const s=[a,"@lunora/client","@lunora/runtime","@lunora/server"];Ue(n)||s.push("@lunora/vite"),r.info(` 1. install the adapter: ${ra(t,s)}`),r.info(" 2. run codegen: lunora codegen"),o==="A"?(r.info(" 3. compose one worker: wrap your worker entry with"),r.info(" createWorker({ httpRouter: <your framework SSR handler>, shardDO: ShardDO, ... })"),r.info(` 4. add the provider: mount the ${a} provider in your root layout/route`),r.info(" 5. make a loader live: preloadQuery() in a loader, usePreloadedQuery() in the component"),r.info(" see https://lunora.sh/docs/frameworks/reactive-loaders")):o==="B"?(r.info(" 3. inject Lunora: mount Lunora realtime under /_lunora/* in your server hook"),r.info(` (${n} owns its Cloudflare adapter — Lunora composes into its server entry)`),r.info(` 4. add the provider: mount the ${a} provider in your root layout`),r.info(" 5. read the guide: https://lunora.sh/docs/frameworks/deploy")):(r.info(" 3. add the provider: wrap your app with the LunoraProvider from @lunora/react"),r.info(" 4. read the guide: https://lunora.sh/docs/frameworks/bring-your-framework")),r.info("")},va=(e,t,r)=>{if(Ue(t))return r.info(`${t} wires Lunora through its server entry, not a lunora() Vite plugin — leaving the Vite config alone (see next steps)`),{code:0,files:[],target:e};const a=$e(e);return a===void 0?ha(e,r):ma(a,e,r)},wa=(e,t)=>{const r=jt(e),a=va(e,r.framework,t);if(a.code!==0)return a;const o=fa(e,t);return ga(r,H(e),t),{code:0,files:[...a.files,...o],target:e}},ya=e=>e.yes!==!0&&(e.prompt!==void 0||(e.interactive??v())),se=async(e,t,r)=>{r.dryRun!==!0&&await lr({apply:a=>ot(e,a),detected:rt(e),interactive:t,logger:r.logger,multiSelect:r.lintPrompt??((a,o,n)=>be(a,o,{...n,badge:f.add}))})},ba=async(e,t)=>{const r=ya(e),a=e.add===void 0?[]:Zt(e.add,s=>{e.logger.warn(s)}),n={applyAll:async s=>{if(s.length===0)return!0;if(e.dryRun===!0)return A(e.logger,`add ${s.map(u=>u.label).join(", ")}`),!0;const i=[],l=v()?{error:u=>{i.push({level:"error",message:u})},info:()=>{},success:()=>{},warn:u=>{i.push({level:"warn",message:u})}}:e.logger,c=s.map(u=>({running:`adding ${u.label}…`,task:()=>It({allowUnsafeSource:e.allowUnsafeSource,cwd:t,from:e.registryFrom,logger:l,names:[...u.names],ref:e.ref,source:e.registrySource,transformManifest:u.transformManifest,yes:!0})})),d=`added ${s.map(u=>u.label).join(", ")}`,h=await bt(f.add,c,d);for(const{level:u,message:y}of i)e.logger[u](y);return h.every(u=>u.code===0)},interactive:r,logger:e.logger,multiSelect:e.prompt?.multiSelect??((s,i,l)=>be(s,i,{...l,badge:f.add})),preselected:a.length>0?a:void 0,projectName:N(t),resolveAuthUiItem:()=>{let s;try{const i=JSON.parse(x(p(t,"package.json"),"utf8"));s={...i.dependencies,...i.devDependencies}}catch{return"auth-ui-react"}if(!At(s))return Et(s)??"auth-ui-react"},select:e.prompt?.select??((s,i,l)=>q(s,i,{...l,badge:f.add})),text:e.prompt?.text??((s,i)=>ye(s,{...i,badge:f.add}))};if(a.length>0){const s=await ee(n);return await se(t,r,e),s}return v()&&await vt(b.extras),await ee(n),await se(t,r,e),!0},V="react",Fe=[{description:"React SPA — official create-vite base + the Lunora layer (the default)",label:"React",value:"react"},{description:"Vue SPA — create-vite base + Lunora",label:"Vue",value:"vue"},{description:"Solid SPA — create-vite base + Lunora",label:"Solid",value:"solid"},{description:"Solid 2.0 SPA — the Solid 2 line (@solidjs/web, vite-plugin-solid 3)",label:"Solid 2",value:"solid-v2"},{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:"Next.js App Router on Vite (vinext) — composed into the Lunora worker (experimental)",label:"vinext · App Router",value:"vinext"},{description:"Next.js Pages Router on Vite (vinext) — composed into one worker (experimental)",label:"vinext · Pages Router",value:"vinext-pages"},{description:"React Router (v7, framework mode) — SSR composed into the Lunora worker",label:"React Router",value:"react-router"},{description:"Astro (islands) — single-worker, Lunora composed into the adapter worker",label:"Astro",value:"astro"},{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 — single-worker, Lunora composed into the adapter 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"}],We=Object.keys(P).join("|"),He=Fe.filter(e=>!D(e.value)).map(e=>e.value),ze=He.join("|"),xa=e=>D(e)?{framework:e,kind:"overlay"}:{kind:"template",templateType:e},ka=async e=>e.vite!==void 0?{framework:e.vite,kind:"overlay"}:e.templateType!==void 0?{kind:"template",templateType:e.templateType}:!v()||e.yes===!0?{framework:V,kind:"overlay"}:xa(await q(b.framework,Fe,{badge:f.tmpl,default:V})??V),Ca=e=>{if(v()||e.yes===!0)return;const t=[];if(e.name===void 0&&t.push("a project name (`lunora init <name>`)"),e.templateType===void 0&&e.vite===void 0&&t.push(`a framework — \`--vite <${We}>\` for an SPA, or \`-t <${ze}>\` for a bespoke template`),t.length!==0)return`lunora init can't prompt in a non-interactive terminal — provide ${t.join(" and ")}, or pass --yes to accept the defaults.`},Sa=async(e,t,r,a,o)=>D(t)?await Te({isLocal:e.overlayBaseFrom!==void 0,logger:e.logger})?(L(a,{recursive:!0}),pa({framework:t,logger:e.logger,markComplete:o,name:r,overlayBaseFrom:e.overlayBaseFrom,target:a})):{code:1,files:[],target:a}:(e.logger.error(`init: unknown framework "${t}". Supported overlays: ${Object.keys(P).join(", ")}.`),{code:1,files:[],target:a}),La=async(e,t,r,a,o)=>e.from!==void 0?await ca(e.from,t,a,r,e.logger,o):e.source!==void 0&&e.source.length>0&&!e.allowUnsafeSource&&!ta(e.source)?(e.logger.error(`init: refusing --source ${e.source} — only gh:, github:, or https:// sources are allowed (and may not contain ".."). Re-run with --allow-unsafe-source if you really want this.`),{code:1,files:[],target:a}):await Te({isLocal:!1,logger:e.logger,source:F(t,e.source,e.ref)})?da({logger:e.logger,markComplete:o,name:r,ref:e.ref,source:e.source,target:a,templateType:t}):{code:1,files:[],target:a},Ma=async(e,t,r)=>{await gt("realtime backend on Cloudflare Workers + Durable Objects");const a=Ca(e);if(a!==void 0)return e.logger.error(a),{code:1,files:[],target:""};const o=Or(),n=e.name??await ye(b.name,{badge:f.dir,default:o,placeholder:o}),s=await ka(e),i=n.trim();if(i.length===0)return e.logger.error("init: refusing an empty project name — pass a directory name (e.g. `lunora init my-app`)."),{code:1,files:[],target:""};if(i.includes("/")||i.includes("\\")||i===".."||i===".")return e.logger.error(`init: refusing project name "${i}" — must not contain path separators or be "." / "..".`),{code:1,files:[],target:""};if(!zr.test(i))return e.logger.error(`init: refusing project name "${i}" — a Cloudflare Worker name must be lowercase letters, digits, "-" or "_" (starting with a letter, digit or "_"), and wrangler rejects anything else. Try \`${Gr(i)}\`.`),{code:1,files:[],target:""};const l=pe(t,i),c=le(l,{throwIfNoEntry:!1});if(c?.isSymbolicLink()===!0)return e.logger.error(`init: refusing to scaffold into "${l}" — it is a symlink. Remove it, or scaffold into a different directory name.`),{code:1,files:[],target:l};const d=c!==void 0;if(d&&ie(l).length>0)return e.logger.error(`target directory not empty: ${l}`),{code:1,files:[],target:l};if(e.dryRun===!0){const h=s.kind==="overlay"?`the ${s.framework} create-vite overlay`:`the ${s.templateType} template`;return A(e.logger,`scaffold ${h} into ${l}`),{code:0,files:[],target:l}}return r.record(l,d),s.kind==="overlay"?Sa(e,s.framework,i,l,r.complete):La(e,s.templateType,i,l,r.complete)},U=(e,t)=>{const{target:r,targetPreExisted:a}=e;if(!(r===void 0||!m(r))){if(a===!0)for(const o of ie(r))R(p(r,o),{force:!0,recursive:!0});else R(r,{force:!0,recursive:!0});t.info(`removed the partially-created project at ${r}`)}},Aa=async(e,t,r)=>e.inPlace!==!0?Ma(e,t,r):e.dryRun===!0?(A(e.logger,`configure Lunora into ${t}`),{code:0,files:[],target:t}):wa(t,e.logger),Ea=async(e,t,r)=>{const a=await ba(e,t.target),o=e.inPlace===!0?void 0:await la(e,t.target);if(e.inPlace!==!0){await na(e,t.target);const n=o??H(t.target);await sa(N(t.target),o,n,Ve(r)),await Xt(e.logger)}return a},Na=(e,t,r)=>{if(t.code!==0||e.ci===void 0)return;if(e.dryRun===!0){A(e.logger,`scaffold a ${e.ci} CI deploy pipeline`);return}const a=e.inPlace===!0?r:t.target;try{const o=H(a);Dt(a,e.ci,o,e.logger)}catch{e.logger.warn(`--ci ${e.ci}: could not detect a package manager for this project — skipped the CI pipeline.`)}},_a=async e=>{const t=e.cwd??process.cwd(),r={};let a;try{a=await Aa(e,t,{complete:()=>{r.target=void 0},record:(o,n)=>{r.target=o,r.targetPreExisted=n}}),a.code===0&&a.target!==""?(r.target=void 0,await Ea(e,a,t)||(a={...a,code:1})):a.code!==0&&U(r,e.logger)}catch(o){if(o instanceof K)return U(r,e.logger),process.stdout.write("\n ✖ Setup cancelled — run `lunora init` again whenever you're ready. 🌙\n"),{code:130,files:[],target:""};throw U(r,e.logger),o}return Na(e,a,t),a},Ia=e=>typeof e=="string"&&He.includes(e),$a=(e,t)=>{if(e!==void 0){if(Ot(e))return e;t.warn(`init: unknown --ci "${e}" — expected github | gitlab; skipping CI scaffold.`)}},Ra=e=>e===void 0?{}:Ia(e)?{templateType:e}:D(e)?{vite:e}:{error:`init: unknown --template "${e}" — expected a bespoke template (${ze}) or an overlay framework (${We}).`},eo=ct(({argument:e,cwd:t,logger:r,options:a})=>{const o=Ra(a.template);return"error"in o?(r.error(o.error),{code:1}):_a({add:a.add,allowUnsafeSource:a.allowUnsafeSource===!0,cwd:t,ci:$a(a.ci,r),dryRun:a.dryRun===!0,from:a.from,inPlace:a.here===!0,interactive:a.interactive===!0?!0:void 0,logger:r,name:e[0],ref:a.ref,source:a.source,templateType:o.templateType,vite:a.vite??o.vite,yes:a.yes===!0})});export{eo as execute,Ia as isTemplate,Ra as resolveTemplateFlag,F as resolveTemplateSource,_a as runInitCommand};