Docs

How Kapow works, one concern per file.

• architecture.md — layers, modules, state flow, DI
• foldable.md — postures, adaptive reading modes, position continuity
• reading-modes.md — the reading surfaces and how they render
• file-formats.md — CBZ / CBR / CB7 / CBT / PDF loading pipeline
• guided-view.md — automatic panel detection and navigation
• speech-bubbles.md — enlarged speech bubbles toggle (detection, layout, overlay)
• training.md — how the panel and bubble detectors are trained, scored and exported
• ml-runtime.md — minimal ONNX Runtime build and ORT-format models: how the AAR and the .ort assets are produced
• library.md — import, storage, metadata, persistence
• stats.md — reading sessions: what is recorded, the pace rule, retention, the stats screen
• settings.md — app settings, themes, backup rules
• onboarding.md — first-launch steps, the DataStore flag, replay from Settings
• review-prompt.md — Play In-App Review request: 3 finished comics, 60-day interval, on reader close
• splash.md — cold-start splash: system splash handover, the 1.3 s Compose sequence, gating
• i18n.md — the bilingual (ES/EN) resource strategy
• performance.md — fluidity baseline on the Fold, how to measure, ranked findings
• glitch-report.md — “Report a visual glitch”: composed page + report.json shared by mail through a FileProvider
• release.md — upload key, signed AAB, bundletool install, Play upload
• privacy.md — the privacy policy published on GitHub Pages (EN + ES)
• bubble-refinement-loop.md — the iterative device-vs-offline loop used to polish bubble rendering
• product-ideas.md — product ideas considered and not scheduled, including the rejected ones
• improvement-ideas.md — measured technical polish ideas not yet on the roadmap

Keep these in sync with the code. If behavior changes, update the matching doc in the same change.