doxa-maps/library/scripts/posters/README.md
Doxa Maps e19697673d
Some checks are pending
Deploy to GitHub Pages / build (push) Waiting to run
Deploy to GitHub Pages / deploy (push) Blocked by required conditions
Doxa Maps — the map bundler, 7 production plugins and the Experimental shelf
2026-09-25 20:07:59 +00:00

19 lines
1.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# library/scripts/posters/ — UPG-100 poster generator
Renders one 3ft × 3ft print poster per zone (28 today) for the **my-upg-100-list** profile, from
the profile's own data. It ships inside the repo alongside that data on purpose — reaching for the
data via an env var once silently rendered stale posters (Nepal, Bangladesh, Bhutan vanished).
```
bun run posters -> posters:shoot -> (WebP previews) -> bun run build
HTML per zone PNG @3000² assets/previews/ app shows them
```
- `generate.mjs` is the template; `shoot.mjs` screenshots to PNG (Firefox only — privacy-first policy).
- A template change is not visible in the app until previews are regenerated **and** the app rebuilt.
- Exported PNGs go to a sibling folder (`../../../upg-100-posters/`), never `public/` — Capacitor
packages `public/` wholesale.
- `snapshots/` holds frozen template versions (v5 is the approved current); each has its own README.
**Full reference — files, env vars, gotchas, measurement discipline:**
**[../../../documentation/architecture/poster-generation.md](../../../documentation/architecture/poster-generation.md)**.