Print-ready field atlases — a modern take on Field Papers, without the scan-back.
Pick an area on a map, choose a style and a grid of pages, and get a PDF atlas built for printing and carrying into the field: an index page up front, one page per grid cell, each with a scale bar, north arrow, and grid reference.
- Interface & output: modeled on Field Papers.
- Rendering process: Headless Chromium (Playwright) driving MapLibre GL JS — no self-hosted tile server. Map data comes straight from stars.optgeo.org.
- Where it runs: docs/index.html (GitHub Pages) is the range picker; rendering itself runs in GitHub Actions or locally — nothing is ever hosted as a standing server.
- Open the range picker: https://dwg7.github.io/zukaku/
- Pick a style, a city, and a grid size; pan/zoom the map underneath the fixed grid to line it up. Click a cell's center toggle to skip printing it (Save Paper) — e.g. a cell that's entirely open water.
- Three ways to turn that into a PDF:
- Print (mainstream, recommended): renders everything right in the tab and opens your browser's own print dialog — no GitHub account, nothing leaves the page. Chromium-based browsers (Chrome, Edge, Brave) work best.
- Share: opens a pre-filled GitHub "create file" page. Commit it (as
a PR if you don't have push access) to
docs/requests/, and the workflow renders a matching PDF intodocs/responses/, reachable athttps://dwg7.github.io/zukaku/responses/<name>.pdf. - JSON: downloads the page spec for local/Docker rendering.
The current state (style, grid size, orientation, title, excluded cells) is reflected in the URL, so you can copy/paste it to share or resume later.
Or run it locally:
npm install
node scripts/render/atlas.js --pages docs/requests/atlas-*.json --out atlas.pdfLarge-scale field maps only (roughly z12 and above) — no scan-back, no QR codes, no small-scale overview maps. See CLAUDE.md for the full rationale and DECISIONS.md for why things are built the way they are.
Everything here is public. This is a public repository, and docs/ is
exactly what GitHub Pages serves — every atlas request and every rendered
PDF is visible to anyone, indefinitely. See
docs/requests/README.md for details.
- CLAUDE.md — scope and design philosophy (read this first)
- HANDOVER.md — current state, what's next
- DECISIONS.md — index of design decisions
- adr/ — full decision records