The Quail Almanac

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_661":662,"_663":664},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_15":16,"_18":19,"_17":-7,"_493":-5,"_20":494,"_22":495,"_496":497,"_498":499,"_26":500,"_24":501,"_502":-5,"_503":-5,"_504":58,"_505":506,"_507":50,"_508":-5,"_509":-5,"_510":511},"routes/_app.x.$handle.$name.branch.$branch.code.$",{"_11":12,"_13":14,"_15":16,"_17":-7,"_18":19,"_20":21,"_22":23,"_24":25,"_26":27,"_28":-5,"_29":-5,"_30":-5,"_31":-5,"_32":-5},"handle","jhiller","name","IncubatorTempHumidityTracker","branchName","main","version","path","frontend","project",{"_38":437,"_13":14,"_51":438,"_439":-5,"_440":58,"_441":442,"_443":442,"_444":-5,"_445":-5,"_446":447,"_448":311,"_449":50,"_450":-5,"_451":-5,"_452":66,"_453":454,"_455":456,"_457":458,"_459":460,"_461":-5,"_462":463,"_464":463,"_465":466,"_467":466,"_468":466,"_469":463,"_470":463,"_471":472,"_473":474,"_475":476,"_477":58},"tree",[95,96,97,98,99,100,101,102],"file",{"_38":91,"_45":46,"_41":44,"_13":19,"_55":-5,"_54":83,"_17":66,"_43":-5,"_51":92,"_47":93,"_59":-5,"_18":94},"contents",[33,34,35,36,37],"upstream","pull","ahead","behind","envVars",{"_38":85,"_13":86,"_41":87,"_43":44,"_45":46,"_47":88,"_49":50,"_51":89,"_17":66,"_54":83,"_55":-5,"_57":58,"_59":-5,"_18":90},{"_38":78,"_13":79,"_41":80,"_43":44,"_45":46,"_47":81,"_49":50,"_51":82,"_17":66,"_54":83,"_55":-5,"_57":58,"_59":-5,"_18":84},{"_38":70,"_13":71,"_41":72,"_43":44,"_45":46,"_47":73,"_49":50,"_51":74,"_17":75,"_54":24,"_55":76,"_57":58,"_59":-5,"_18":77},{"_38":61,"_13":62,"_41":63,"_43":44,"_45":46,"_47":64,"_49":50,"_51":65,"_17":66,"_54":67,"_55":68,"_57":58,"_59":-5,"_18":69},{"_38":39,"_13":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_17":53,"_54":24,"_55":56,"_57":58,"_59":-5,"_18":60},"id","a59b1dc4-e4d0-4e21-9ed4-47b9019a431f","manifest.json","fileId","6d528f88-f7ed-11f0-8a0d-42dde27851f2","parentId","30c14402-f5bc-11f0-90d9-42dde27851f2","branchId","5306ba64-f5b8-11f0-aa92-42dde27851f2","branchVersion",274,"latest",true,"createdAt",["D",1783402251410],1,"fileType","content","{\n \"name\": \"The Quail Almanac\",\n \"short_name\": \"Almanac\",\n \"description\": \"A daily register for Coturnix quail egg incubation\",\n \"start_url\": \"/\",\n \"display\": \"standalone\",\n \"background_color\": \"#f0e6cd\",\n \"theme_color\": \"#efe4c9\",\n \"icons\": [\n {\n \"src\": \"/frontend/icons/icon-192.svg\",\n \"sizes\": \"192x192\",\n \"type\": \"image/svg+xml\"\n },\n {\n \"src\": \"/frontend/icons/icon-512.svg\",\n \"sizes\": \"512x512\",\n \"type\": \"image/svg+xml\"\n }\n ]\n}\n","deleted",false,"label",[19,40],"31b2708e-f5bc-11f0-a1cb-42dde27851f2","index.tsx","31b2714c-f5bc-11f0-a1cb-42dde27851f2",15,["D",1768884908404],0,"script","/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React from \"https://esm.sh/react@18.2.0\";\nimport { createRoot } from \"https://esm.sh/react-dom@18.2.0/client\";\nimport { App } from \"./components/App.tsx\";\n\nconst root = createRoot(document.getElementById(\"root\")!);\nroot.render();\n",[19,62],"7976f3cf-1e70-40ff-8abd-f1a855e6db20","index.html","3195b9ee-f5bc-11f0-9ddc-42dde27851f2",263,["D",1783401832162],9,"\n\n\n \n \n The Quail Almanac\n\n \n \n \n\n \n \n \n \n \n \n \n \n \n \n 🥚\">\n \n\n\n

\n \n\n\n",[19,71],"6d3e8c68-f7ed-11f0-8a0d-42dde27851f2","icons","6d3e8d6c-f7ed-11f0-8a0d-42dde27851f2",196,["D",1769125956055],"directory",[19,79],"31309302-f5bc-11f0-a7c1-42dde27851f2","components","313093e8-f5bc-11f0-a7c1-42dde27851f2",6,["D",1768884907625],[19,86],"30c1433a-f5bc-11f0-90d9-42dde27851f2",["D",1768884906906],2,[19],{"_38":421,"_13":422,"_41":423,"_43":-5,"_45":46,"_47":117,"_49":50,"_51":424,"_17":66,"_54":83,"_55":-5,"_57":58,"_59":-5,"_109":425,"_18":426},{"_38":299,"_13":300,"_41":301,"_43":-5,"_45":46,"_47":262,"_49":50,"_51":302,"_17":66,"_54":83,"_55":-5,"_57":58,"_59":-5,"_109":303,"_18":304},{"_38":91,"_13":19,"_41":44,"_43":-5,"_45":46,"_47":93,"_49":50,"_51":173,"_17":66,"_54":83,"_55":-5,"_57":58,"_59":-5,"_109":174,"_18":175},{"_38":137,"_13":138,"_41":139,"_43":-5,"_45":46,"_47":140,"_49":50,"_51":141,"_17":66,"_54":83,"_55":-5,"_57":58,"_59":-5,"_109":142,"_18":143},{"_38":129,"_13":130,"_41":131,"_43":-5,"_45":46,"_47":132,"_49":50,"_51":133,"_17":66,"_54":24,"_55":134,"_57":58,"_59":-5,"_109":135,"_18":136},{"_38":121,"_13":122,"_41":123,"_43":-5,"_45":46,"_47":124,"_49":50,"_51":125,"_17":66,"_54":24,"_55":126,"_57":58,"_59":-5,"_109":127,"_18":128},{"_38":112,"_13":113,"_41":114,"_43":-5,"_45":46,"_47":115,"_49":50,"_51":116,"_17":117,"_54":24,"_55":118,"_57":58,"_59":-5,"_109":119,"_18":120},{"_38":103,"_13":104,"_41":105,"_43":-5,"_45":46,"_47":106,"_49":50,"_51":107,"_17":66,"_54":24,"_55":108,"_57":58,"_59":-5,"_109":110,"_18":111},"31cfa0dc-f5bc-11f0-920d-42dde27851f2","deno.json","31cfa1ae-f5bc-11f0-920d-42dde27851f2",19,["D",1768884908674],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/98f62cee78e85bfc47c62ed703777c6bc8794f1c/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": true,\n \"types\": [\"https://www.val.town/types/valtown.d.ts\"],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"include\": [\"deno:/https/esm.town/**/*\"],\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}","children",[],[104],"b5fa3335-06c6-4540-b4f6-592ed25e8ca8","CLAUDE.md","81f6de80-f752-11f0-8d59-42dde27851f2",275,["D",1783402413414],3,"# CLAUDE.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.\n\n## Project Overview\n\nQuail egg incubator monitoring system built on Val Town. Receives temperature data from a single LoRaWAN sensor — a NanoThings NanoTag — via ChirpStack webhooks, stores readings in SQLite, sends temperature email alerts, and displays a React dashboard.\n\n**Live URL:** https://quail-incubator.val.run/\n\n> **Sensor history:** The system originally ran a RAK7204 (temp + humidity, Cayenne LPP) alongside the NanoTag. As of July 2026 the RAK7204 was retired and the NanoTag (temperature-only) is the sole sensor. There is no humidity sensor anymore — humidity monitoring and humidity alerts were removed.\n\n## Development Commands\n\n```bash\n# Start local development with auto-sync to Val Town\n~/.deno/bin/vt watch\n\n# The app auto-deploys on save - no build step required\n```\n\n## Architecture\n\n### Platform: Val Town\n- Runs on Deno in a serverless context (not Node.js)\n- Entry point: `backend/index.http.tsx` exports `app.fetch`\n- Database: **per-val (project-scoped) SQLite** via `https://esm.town/v/std/sqlite/main.ts`\n- Email: Val Town's email service via `https://esm.town/v/std/email`\n- File serving: `https://esm.town/v/std/utils` for `readFile` and `serveFile`\n\n### Data Flow\n1. ChirpStack sends LoRaWAN uplinks to `/webhook/chirpstack?event=up`\n2. Webhook processes only the configured NanoTag DevEUI (`shared/constants.ts` → `DEVICE_EUIS.NANOTAG`); any other device is logged and ignored\n3. NanoTag payload decoded by fPort: ports 26/27 = temperature, ports 1/13/21/31/32 = battery\n4. Temperature readings stored in `incubator_nanotag_readings_v1`\n5. Each temperature reading triggers a temperature alert check (calibrated NanoTag temp). Humidity is passed as `null` throughout, so humidity alert checks are skipped\n6. Dashboard polls `/api/status` and `/api/readings/nanotag` every 60 seconds\n\n### Sensor Calibration\nDefined in `shared/constants.ts`:\n- NanoTag: +1°F offset (`CALIBRATION.nanotagTemperatureF`)\n- Backend stores raw temperature; the dashboard and alert logic apply the offset\n\n### Incubation Logic\n- 17-day Coturnix quail incubation starting from `INCUBATION_CONFIG.startDate`\n- Lockdown phase begins day 15 (advisory only — no humidity sensor to enforce it)\n- Temperature thresholds: ideal 101-102°F, warning ±3°F, critical ±5°F\n- Alerts rate-limited: critical every 5 min, warning every 30 min\n- Mode (`incubation`/`brooder`) and `hatch_date` are stored in the `incubator_config_v1` table; brooder mode auto-activates on day 19+. To restart the clock for a new batch, update `INCUBATION_CONFIG.startDate` AND clear the `mode`/`hatch_date` config rows (or start from a fresh per-val DB).\n\n### Frontend\n- React 18.2.0. Layout utilities via twind (Tailwind CDN); the visual design lives in a hand-written CSS system in `frontend/index.html` (`