How eriwinsto/ak-results-2026 works
This repository produces and publishes a static Alaska election-results experience. The main workflow transforms Division precinct results into race data, then serves it alongside map geometry and basemap data for the reader-facing page. Separate stages prepare ranked-choice rounds and geography; the page also offers race tabs, map views, balance-of-power, and Grove embedding. Source excerpts establish the data-building behavior, while page-level interactions and some data reads are documented in the README rather than sampled source.
Main entry points: index.html Results page · build_data.py Results builder · build_rcv.py Ranked-choice builder · results.json Race results data
Components 15
Data preparation
- Election configuration
config - Results builder
scripts/build_data.py - Ranked-choice builder
scripts/build_rcv.py - Precinct geometry builder
scripts/build_geo.py - Basemap builder
scripts/build_base.py
Published data
- Race results data
site/data/results.json - Ranked-choice data
site/data/rcv - District geometry
site/data/geo.json - Basemap layers
site/data/base.json
Reader experience
- Results page
site/index.html - Grove embed snippet
grove-embed.html
Other components
- Division results CSV
- RCTab reports
- Election reader
- Grove host
Connections 16
- Division results CSV → Results builder: provides CSV
README.md - Election configuration → Results builder: configures races
scripts/build_data.py - Results builder → Race results data: writes results
scripts/build_data.py - RCTab reports → Ranked-choice builder: provides report
README.md - Race results data → Ranked-choice builder: matches candidate names
scripts/build_rcv.py - Ranked-choice builder → Ranked-choice data: writes rounds
scripts/build_rcv.py - Precinct geometry builder → District geometry: writes geometry
scripts/build_geo.py - District geometry → Basemap builder: supplies precincts
scripts/build_base.py - Basemap builder → Basemap layers: writes layers
scripts/build_base.py - Election reader → Results page: views results
README.md - Results page → Race results data: reads results
README.md - Results page → Ranked-choice data: shows rounds
README.md - Results page → District geometry: renders map
README.md - Results page → Basemap layers: renders basemap
README.md - Grove host → Grove embed snippet: hosts embed
README.md - Grove embed snippet → Results page: embeds page
README.md