[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_634":635,"_636":637},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_15":16,"_17":18,"_50":-7,"_232":-5,"_19":233,"_234":235,"_236":237,"_238":239,"_240":241,"_21":242,"_243":-5,"_244":-5,"_245":24,"_246":247,"_248":190,"_249":-5,"_250":-5,"_251":252},"routes/_app.x.$handle.$name.branch.$branch.history_.$",{"_11":12,"_13":14,"_15":16,"_17":18,"_19":20,"_21":22,"_23":24,"_25":26,"_27":28,"_29":24,"_30":-5},"handle","pikachu","name","Quickstart-Full-Stack","branchName","main","path","README.md","project",{"_44":176,"_13":14,"_48":177,"_178":-5,"_179":24,"_180":181,"_182":181,"_183":184,"_185":186,"_30":77,"_187":188,"_189":190,"_191":-5,"_192":-5,"_193":194,"_52":53,"_195":196,"_197":198,"_199":200,"_201":-5,"_202":203,"_204":203,"_205":206,"_207":206,"_208":206,"_209":203,"_210":203,"_63":211,"_212":213,"_214":215,"_216":24},"file",{"_73":74,"_13":18,"_75":21,"_76":24,"_175":-5},"isDirectory",false,"page",0,"history",[31,32,33,34,35,36,37,38,39,40,41,42,43],"hasNext","userId",{"_44":167,"_46":47,"_48":168,"_50":169,"_52":53,"_54":170,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":171,"_21":172,"_66":-5,"_67":-5,"_68":-5,"_69":-5,"_70":173},{"_44":159,"_46":47,"_48":160,"_50":161,"_52":53,"_54":162,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":163,"_21":164,"_66":-5,"_67":-5,"_68":-5,"_69":-5,"_70":165},{"_44":151,"_46":47,"_48":152,"_50":153,"_52":53,"_54":154,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":155,"_21":156,"_66":-5,"_67":-5,"_68":-5,"_69":-5,"_70":157},{"_44":143,"_46":47,"_48":144,"_50":145,"_52":53,"_54":146,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":147,"_21":148,"_66":-5,"_67":-5,"_68":-5,"_69":-5,"_70":149},{"_44":135,"_46":47,"_48":136,"_50":137,"_52":53,"_54":138,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":139,"_21":140,"_66":-5,"_67":-5,"_68":-5,"_69":-5,"_70":141},{"_44":127,"_46":47,"_48":128,"_50":129,"_52":53,"_54":130,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":131,"_21":132,"_66":-5,"_67":-5,"_68":-5,"_69":-5,"_70":133},{"_44":119,"_46":47,"_48":120,"_50":121,"_52":53,"_54":122,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":123,"_21":124,"_66":-5,"_67":-5,"_68":-5,"_69":-5,"_70":125},{"_44":112,"_46":47,"_48":113,"_50":114,"_52":53,"_54":104,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":115,"_21":116,"_66":-5,"_67":-5,"_68":-5,"_69":-5,"_70":117},{"_44":104,"_46":47,"_48":105,"_50":106,"_52":53,"_54":107,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":108,"_21":109,"_66":-5,"_67":-5,"_68":-5,"_69":-5,"_70":110},{"_44":96,"_46":47,"_48":97,"_50":98,"_52":53,"_54":99,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":100,"_21":101,"_66":-5,"_67":-5,"_68":-5,"_69":-5,"_70":102},{"_44":88,"_46":47,"_48":89,"_50":90,"_52":53,"_54":91,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":92,"_21":93,"_66":-5,"_67":-5,"_68":-5,"_69":-5,"_70":94},{"_44":80,"_46":47,"_48":81,"_50":82,"_52":53,"_54":83,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":84,"_21":85,"_66":-5,"_67":-5,"_68":-5,"_69":-5,"_70":86},{"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":64,"_21":65,"_66":-5,"_67":-5,"_68":-5,"_69":-5,"_70":71},"id","aac24196-48c5-11f1-9920-42b51c65c3df","branchId","5a0a7ac8-4895-11f1-80ec-42b51c65c3df","createdAt",["D",1778014923474],"version",7,"orgId","019df771-9af8-7238-99a4-541e39355038","parentId","aababc64-48c5-11f1-831b-42b51c65c3df","incomingCommitId","aiChatMessageId","aiChatThreadId","aiChatThreadUserId","aiChatThreadTitle","source","clientLabel","user",{"_44":77,"_52":53,"_11":12,"_78":79},{"_73":74,"_13":18,"_75":21,"_76":24},"pull","merge","revert","multiple","commits",[72],{"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":64,"_21":65,"_66":-5,"_67":-5,"_68":-5},"fileId","aabf7b64-48c5-11f1-9920-42b51c65c3df","fileType","deleted","173e7424-8658-428f-a3bc-ae4faeaabd1c","avatar","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/22c8ba37-42c8-4af4-8daf-8cdd2f5f1800/square512?exp=1789538399&sig=21cdba23f818845c8391e88088eb5ea9255dbc43e05efe79e25bd70ab9ddb43a","5a42b602-491e-11f1-9e87-42b51c65c3df",["D",1778053013652],11,"ab16bbae-48c5-11f1-a16f-42b51c65c3df",{"_44":77,"_52":53,"_11":12,"_78":79},{"_73":74,"_13":18,"_75":21,"_76":24},[87],{"_44":80,"_46":47,"_48":81,"_50":82,"_52":53,"_54":83,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":84,"_21":85,"_66":-5,"_67":-5,"_68":-5},"7c90f006-496f-11f1-b9b1-42b51c65c3df",["D",1778087860492],54,"7c7474d0-496f-11f1-b7b0-42b51c65c3df",{"_44":77,"_52":53,"_11":12,"_78":79},{"_73":74,"_13":18,"_75":21,"_76":24},[95],{"_44":88,"_46":47,"_48":89,"_50":90,"_52":53,"_54":91,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":92,"_21":93,"_66":-5,"_67":-5,"_68":-5},"a956c21a-4b17-11f1-b038-ee650bb23af1",["D",1778270041957],61,"a92daea2-4b17-11f1-a377-ee650bb23af1",{"_44":77,"_52":53,"_11":12,"_78":79},{"_73":74,"_13":18,"_75":21,"_76":24},[103],{"_44":96,"_46":47,"_48":97,"_50":98,"_52":53,"_54":99,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":100,"_21":101,"_66":-5,"_67":-5,"_68":-5},"49ac0b04-4b21-11f1-b54f-ee650bb23af1",["D",1778274176609],100,"49a00e26-4b21-11f1-8ab3-ee650bb23af1",{"_44":77,"_52":53,"_11":12,"_78":79},{"_73":74,"_13":18,"_75":21,"_76":24},[111],{"_44":104,"_46":47,"_48":105,"_50":106,"_52":53,"_54":107,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":108,"_21":109,"_66":-5,"_67":-5,"_68":-5},"392e9834-4b7e-11f1-8585-ee650bb23af1",["D",1778314092196],101,{"_44":77,"_52":53,"_11":12,"_78":79},{"_73":74,"_13":18,"_75":21,"_76":24},[118],{"_44":112,"_46":47,"_48":113,"_50":114,"_52":53,"_54":104,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":115,"_21":116,"_66":-5,"_67":-5,"_68":-5},"0cdb87bc-4b8b-11f1-89d0-ee650bb23af1",["D",1778319601219],109,"0ccbf7e8-4b8b-11f1-ae50-ee650bb23af1",{"_44":77,"_52":53,"_11":12,"_78":79},{"_73":74,"_13":18,"_75":21,"_76":24},[126],{"_44":119,"_46":47,"_48":120,"_50":121,"_52":53,"_54":122,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":123,"_21":124,"_66":-5,"_67":-5,"_68":-5},"ea2ca98c-4f02-11f1-a378-ee650bb23af1",["D",1778700936138],229,"ea21bd74-4f02-11f1-ac5b-ee650bb23af1",{"_44":77,"_52":53,"_11":12,"_78":79},{"_73":74,"_13":18,"_75":21,"_76":24},[134],{"_44":127,"_46":47,"_48":128,"_50":129,"_52":53,"_54":130,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":131,"_21":132,"_66":-5,"_67":-5,"_68":-5},"b2da1cbc-346c-4ce7-a76d-fbfbfeda2a25",["D",1788104438281],252,"772d3196-7aa2-4d38-9fc7-4700d1067721",{"_44":77,"_52":53,"_11":12,"_78":79},{"_73":74,"_13":18,"_75":21,"_76":24},[142],{"_44":135,"_46":47,"_48":136,"_50":137,"_52":53,"_54":138,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":139,"_21":140,"_66":-5,"_67":-5,"_68":-5},"8131d065-ab19-49a4-9196-c6359da717a1",["D",1788116690388],268,"ebdce344-bfbc-4202-83a3-659f8f6facf0",{"_44":77,"_52":53,"_11":12,"_78":79},{"_73":74,"_13":18,"_75":21,"_76":24},[150],{"_44":143,"_46":47,"_48":144,"_50":145,"_52":53,"_54":146,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":147,"_21":148,"_66":-5,"_67":-5,"_68":-5},"ce2ddc36-f626-4cda-a941-cd1b85aab662",["D",1788119016695],284,"5c1ab552-b842-4ab1-9c34-de28475efa3e",{"_44":77,"_52":53,"_11":12,"_78":79},{"_73":74,"_13":18,"_75":21,"_76":24},[158],{"_44":151,"_46":47,"_48":152,"_50":153,"_52":53,"_54":154,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":155,"_21":156,"_66":-5,"_67":-5,"_68":-5},"01e897e5-2578-4c3d-ac29-1608a192f259",["D",1788122839143],305,"af209040-0ce7-46a7-93ad-c4f007fc9678",{"_44":77,"_52":53,"_11":12,"_78":79},{"_73":74,"_13":18,"_75":21,"_76":24},[166],{"_44":159,"_46":47,"_48":160,"_50":161,"_52":53,"_54":162,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":163,"_21":164,"_66":-5,"_67":-5,"_68":-5},"93e0806e-efe6-4001-98e8-db260e7a8d16",["D",1788140102864],347,"8c9f6ce4-2798-49a0-8426-d7ca8033da6f",{"_44":77,"_52":53,"_11":12,"_78":79},{"_73":74,"_13":18,"_75":21,"_76":24},[174],{"_44":167,"_46":47,"_48":168,"_50":169,"_52":53,"_54":170,"_56":-5,"_57":-5,"_58":-5,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":171,"_21":172,"_66":-5,"_67":-5,"_68":-5},"deletedAtVersion","5a09ae54-4895-11f1-80ec-42b51c65c3df",["D",1777994172310],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","An elegant template for an elegant single-person full stack app.","imageUrl","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/3ed9401e-3850-4a69-dec2-1bdd924c0900/square512?exp=1789538399&sig=8ded5b974bfebef9817e2fbdffe4de4e1704e0d4cab9518c811db2594c0af107","pinnedFileId","e1c705aa-4b18-11f1-b4ae-ee650bb23af1","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",1,"tursoName","5a09ae54489511f180ec42b51c65c3df","tursoHostname","5a09ae54489511f180ec42b51c65c3df-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789511441255],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm",{"_11":12,"_231":79},"org",{"_11":12,"_226":227,"_78":79,"_30":77,"_228":229,"_230":24},"branch",{"_50":217,"_13":16,"_44":47,"_218":176,"_219":-5,"_220":-5,"_221":-5,"_222":-5,"_223":-5,"_224":14,"_225":12},"isOwned",384,"projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","Minion","tier","free","canRestrictVals","profileImageUrl","adoptOrgId",{"_44":176,"_13":14,"_48":629,"_178":-5,"_179":24,"_180":181,"_182":181,"_183":184,"_185":186,"_30":77,"_187":188,"_189":190,"_191":-5,"_192":-5,"_193":194,"_52":53,"_195":196,"_197":198,"_199":630,"_201":-5,"_202":203,"_204":203,"_205":206,"_207":206,"_208":206,"_209":203,"_210":203,"_63":631,"_212":632,"_214":633,"_216":24},"tree",[272,280,302,305,306,307,308,309,310],"files",[272,273,274,275,276,277,278,279,280,281,282,283,284,285,286,287,288,289,290,291,292,293,294,295,296,297,298,299,300,301,302,303,304,305,306,307,308,309,310],"counts",{"_262":26,"_263":194,"_264":194,"_265":266,"_267":268},"contents",[],{"_44":253,"_13":18,"_73":74,"_54":-5,"_46":47,"_254":169,"_255":190,"_48":256,"_50":257,"_75":21,"_258":259,"_76":24,"_260":-5,"_17":261},"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},"3d8b63af-625e-401b-a675-b02284a05ddf","branchVersion","latest",["D",1788140102864],12,"content","# Val Town Quickstart\n\nA live, forkable full-stack Val Town starter — disguised as a working app. Sign in, add a reminder\nto the shared list, email its inbox and watch AI triage it as spam or not. Then fork it and swap in\nyour own idea. Sized for a solo project or a family's shared tools (<10 people), not an enterprise\nplatform.\n\n**Try it live, then fork:** open this App, click **Fork this App** on the home page. `vtx new` (see\nbelow) is for the CLI-first workflow inside this monorepo; forking on val.town works standalone too.\n\nAll demo data (the shared Reminders list, the AI email inbox) is public and is **permanently deleted\n24 hours after creation** — see `backend/db.ts`'s `pruneOld*` functions and `cron.ts`. Don't put\nanything sensitive in it.\n\nThe UI is built on [Astryx](https://astryx.atmeta.com), Meta's open-source React + StyleX design\nsystem. See [`_specs/astryx-template.md`](../../_specs/astryx-template.md) for the migration\nhistory, version pins, and the Deno SSR workarounds.\n\n`_template` is excluded from main-branch deployment because its directory starts with `_`.\n\nSince every Val Town HTTP val is browsable source, the deployed copy of this App is readable at\n`https://www.val.town/x///code/` — e.g.\n`https://www.val.town/x/pikachu/Val-Town-Quickstart/code/backend/auth.ts`. In-app \"view source\" and\n\"Fork\" links use this same pattern (see `VAL_TOWN_USERNAME` below).\n\n---\n\n## What it demos\n\n| Page | What you'll see |\n| ------------ | -------------------------------------------------------------------------------------------------------- |\n| `/` (Home) | Demo-first landing: fork CTA, live-demo cards, then the building blocks |\n| `/reminders` | **Flagship demo.** Shared list any signed-in user can add to / check off / delete |\n| `/email` | **AI demo.** Your App's real inbound address; a free GPT-mini model triages spam and summarises the rest |\n| `/anatomy` | Block diagram of Val Town's infra layer, this App's routing, and its core stack |\n| `/http` | HTTP routes and live request demos |\n| `/sqlite` | Visit log and admin controls |\n| `/cron` | Scheduled task history — this is what wipes demo data every 24h |\n| `/blob` | Sign-in-gated Blob read/write/list demo, keys namespaced per user |\n| `/ui` | Astryx theming explainer + component showcase |\n\n## Create Your Own Fork\n\n**On val.town:** open the deployed App → **Fork this App** on the home page → rename → done.\n\n**Inside this monorepo**, from any directory after sourcing the uApps shell plugin:\n\n```bash\nvtx new my-app\ncd vals/my-app\nvtx status\nvtx push --dry-run\nvtx push\nvtx url\n```\n\n`vtx new` copies the template, replaces the application name and account-scoped Blob prefix, writes\nthe new `val.yml` name, and links the new remote val. Existing destinations are refused.\n\n## Application Shape\n\nThe HTTP entry wraps the app in Val Town OAuth, routes `/api/*` through typed auth boundaries, and\nrenders the selected SSR page for every other path.\n\nAPI routes:\n\n| Method | Path | Access |\n| ------ | ----------------------- | ---------------------- |\n| `GET` | `/api/health` | Public |\n| `GET` | `/api/me` | Public session context |\n| `GET` | `/api/visits` | Public |\n| `POST` | `/api/prune-visits` | Admin |\n| `GET` | `/api/cron-runs` | Public |\n| `GET` | `/api/reminders` | Public read |\n| `POST` | `/api/reminders` | Signed-in |\n| `POST` | `/api/reminders/done` | Signed-in |\n| `POST` | `/api/reminders/delete` | Signed-in |\n| `GET` | `/api/emails` | Public read |\n| `GET` | `/api/blob-keys` | Signed-in, per-user |\n| `POST` | `/api/blob-write` | Signed-in, per-user |\n| `GET` | `/api/blob-read` | Signed-in, per-user |\n| `GET` | `/api/admin/users` | Super-admin |\n| `POST` | `/api/admin/set-admin` | Super-admin |\n\n\"Signed-in\" means any authenticated Val Town user — see `backend/auth.ts`'s `getAuthedUc` — not just\nadmins. This App is deliberately open: it's a shared demo, not a private tool.\n\n## Runtime Configuration\n\nSet these in the created val's Val Town environment UI, never in Git or GitHub Actions:\n\n| Variable | Kind | Purpose |\n| ------------------- | -------- | -------------------------------------------------------------------------------------- |\n| `APP_NAME` | Optional | Display name override |\n| `VAL_TOWN_USERNAME` | Optional | Your Val Town username — powers \"view source\"/Fork links and the inbound email address |\n| `DAILY_HOUR_UTC` | Optional | Daily task hour, `0`–`23` UTC |\n| `AUTH_SUPER_ADMINS` | Optional | Comma-separated Val Town usernames |\n\nNo API key is needed for the AI email triage — `backend/ai.ts` uses Val Town's free-tier\n`ValTownOpenAI` proxy.\n\nThe repository-level `VAL_TOWN_API_KEY` secret is only for CI deployment. See the root\n[`README.md`](../../README.md#cicd).\n\n## Trigger Contract\n\n`val.yml.files` declares the intended remote types:\n\n```yaml\nfiles:\n index.http.ts: http\n cron.ts: interval\n email.ts: email\n```\n\nRun `vtx types` after linking. Use `vtx apply-types` only when deliberately repairing remote trigger\nmetadata.\n\n## Architecture\n\n- `index.http.ts` — HTTP composition root: per-route SSR page serving, `GET /theme` (zero-JS mode\n switch), and the API route table.\n- `backend/auth.ts` — OAuth context and role enforcement (`getUc`/`getAuthedUc`/`getAdminUc`/\n `getSuperAdminUc`). Auth types use `Cxt` (e.g. `UserCxt`, `RouteCxt`) — the more common short form\n for \"context\" — not `Ctx`.\n- `backend/handlers.ts` — focused API handlers, including Reminders CRUD and the email inbox list.\n- `backend/db.ts` — retryable migration, visits, Cron runs, users, Reminders, and the inbound email\n log — the latter two carry a 24h retention window baked into every query.\n- `backend/ai.ts` — spam/summary triage via Val Town's free `ValTownOpenAI` proxy, using Structured\n Outputs so the response is guaranteed valid JSON.\n- `backend/storage.ts` — val-namespaced account Blob access, with per-user key sub-prefixing.\n- `frontend/app.tsx` — React SSR composition root; dispatches one page per request via a `PAGES` map\n (no client-side router — navigation is real ``).\n- `frontend/astryx/` — pinned Astryx component barrel (`components.ts`), the RAF/CAF SSR shim\n (`ssr-shims.ts`), and the side-nav/theme-form shell (`shell.tsx`).\n- `frontend/pages/` — one file per route, composed from Astryx components. `home.tsx` leads with the\n live demos and a Fork CTA; `page-anatomy.tsx` is the code deep-dive for visitors who want it.\n- `frontend/pages/kit.tsx` — shared page pieces: `SourceLink`/`SourceLinkList` (\"view source\") and\n `ForkButton` — both degrade gracefully when `VAL_TOWN_USERNAME` is unset.\n- `frontend/client.ts` — non-hydrated demo API wiring only (no router, no theme JS — both are\n server-driven). Dynamic table rows (Reminders, the email inbox) are cloned from a hidden, real\n Astryx-rendered `

History · README.md