Berean Dashboard Architecture

index.html: 16,096 lines, 892 KB. Reader, pocket mode, study layer, lexicon, Deeper with cross references, Search, Partner UI, exports, speech, settings, sync, the study log, the peek, verse landing, the camera — live, frozen, from a photo, or on a Mac through an iPhone — and, since v45, the Verse Cockpit at /cockpit: one verse in the middle, the tagged original beneath it, the helps in columns either side, the AI in three groups one gesture away, and the King James words that have quietly changed sense marked in the verse itself. 79 @testable blocks.
manifest.json: Name, icons, standalone display — what makes "Add to Home Screen" an app.
doc pages: about · manual · field guide · why · architecture · Hebrew 101 · Greek 101 · Patterns Lab · ELS Explorer · change log · inductive method · /watch. Folding header on phones.

localStorage: One key. Notes, marks, named studies, legend, settings. Safety-critical: every write path is tested against a throwing store. Still the source of truth with sync on.
KV · NOTES (v39): One sealed blob per passphrase-derived vault id, encrypted on the device with AES-GCM under a key the server never sees. Field-level three-way merge on the device; conflicts keep both sides. No reset. The worker answers 503 naming the binding if it is missing.
IndexedDB: Pictures in notes — kept apart so a big photo can never cost a sentence.
sw.js: Precaches the shell; network-first for the app, cache-first for chapters; a real Response every time, never undefined.

bolls.life: Every translation on the page and the BDB/Thayer dictionary. KJV is the one that counts — it drives search and analytics.
sidecars: ocr/ — Tesseract in WebAssembly and the English model, ~6 MB on the first shutter press, never at boot (v42); text-KJV/WEB/YLT, text-WLCC, text-NTGT, seq-ot/nt, wordfreq ×3, eng2strong-KJV, and since v39 xrefs.json — 344,756 openbible.info cross references, CC BY 4.0. Ship with the app, loaded on demand, never at boot.

helloao: Gill, Henry, Jamieson-Fausset-Brown — rendered in, verse-keyed, cached per chapter.
Enduring Word: Guzik is a per-chapter link and nothing else, by written permission; a suite fails the build if that ever changes.
Blue Letter Bible: The shelf for lookups: deep links carry book, chapter, verse and version.

_worker.js: 577 lines. Holds the system prompt and docs/DOCTRINE.md's 27 load-bearing phrases; streams SSE; answers 503 naming the missing setting. Since v39 also /api/notes, a GET and a PUT of a blob it cannot read.
Coach: claude-haiku-4-5 — the default seat, pinned by nine literal values and a prompt hash.
Teacher: claude-sonnet-5, opt-in, five method lenses, never fabricates a living teacher's words. Env-overridable.
Workers AI: llama-3.1-8b fallback when no key is set; the engine badge always says which answered.

117 suites: Plain Node, no browser. Bonds as well as tests: version-agreement, docs-version-agreement, board-arithmetic, guzik-linked-not-hosted.
deploy.yml: Push to main only. Guard 19 files, parse the inline script, run every suite, check APP_VER = sw VER, deploy, curl for 200.
R2 · /studies/: Weekly study PDFs published behind a token, served as unlisted links.

Where a verse comes from, and where your notes go