Mobile-first map of Omaha-area restaurant happy hours, specials, and vouchers.
Live: https://nitrocode.github.io/omaha-deals-map/
| Kind | Source | Shape |
|---|---|---|
| Happy hour | growomaha.com | Weekly recurring (day-of-week, time window) |
| Special | visitomaha.com | Date-range coupon |
| Voucher | omaha.bigdealsmedia.net | Pre-paid discount (Groupon-style) |
Updated weekly by GitHub Actions; you can also rescrape locally any time.
make install # one-time
make all # fetch + parse + extract + geocode + build
make serve # serve site/ at http://localhost:8000Caching is comprehensive. Re-running make all only hits the network for content that's actually changed:
| Cache | File | Survives across runs? |
|---|---|---|
| HTTP body + ETag/Last-Modified | data/http_cache.yaml |
yes (per-URL) |
| Per-source raw snapshots | data/raw/<source>/latest.pickle |
yes (gitignored binary) |
| Geocode name -> lat/lng | data/geocode_cache.yaml |
yes |
Use make rebuild to force every cache miss.
Install once:
pip install -e ".[dev]" # installs pre-commit
pre-commit install # registers hooks under .git/hooks/After that, every git commit runs:
verify-srion any changed HTML file. Fetches each<link>/<script>with anintegrity=attribute and checks the declared hash against the actual served content. Catches the failure mode where someone (me, on 4473ba5) commits a fabricated hash.ruff checkon Python filespytest -q -m "not slow"the fast test suite
CI runs the same python scripts/check_sri.py site/index.html so PRs without pre-commit installed still get the gate.
Run manually any time:
pre-commit run --all-files
python scripts/check_sri.py site/index.html # just the SRI checkIndividual stages: make scrape, make parse, make extract, make geocode, make build. make rebuild forces every stage to bypass caches.
- Create
sources/<name>/__init__.py,fetch.py,parse.py. - Implement
fetch(client=None, cache_path=None) -> SomePayloadandparse(payload) -> list[SourceRecord]. - Add the name to
sources/registry.yaml. - Add a fixture + parser test in
tests/(capture via curl intotests/fixtures/<name>/). - Run
make all.
Edit these YAML files in data/overrides/ and rerun make build:
addresses.yamlhand-fixes bad geocodes by restaurant id, e.g.blue-sky-patio: {address: "1234 X", lat: 41.25, lng: -95.93}.categories.yamlassigns cuisine + neighborhood per restaurant id.personal.yamlholds your tags/ratings/notes (gitignored; stays local).merges.yamldeclares "these source-record ids are the same restaurant" so deals merge into one map pin.
make reviewPrints any restaurant where geocoding or time extraction failed, with the override file you'd edit to fix it.
01_fetch -> raw/<source>/latest.pickle
02_parse -> parsed.yaml
03_extract_times -> extracted.yaml (regex; ~96% coverage, the rest flagged needs_review)
04_geocode -> geocoded.yaml (override -> source -> cache -> Nominatim -> Photon)
05_build -> deals.json (and site/data.json)
Caches (data/http_cache.yaml, data/geocode_cache.yaml) make repeated runs near-instant.
make reviewshows lots of needs_review entries. Usually Nominatim couldn't find a confident match. Fix indata/overrides/addresses.yaml.- Site shows nothing. Open browser console. If
data.json: 404, the Pages build hasn't run yet; push any change todata/deals.json,site/, or run theDeploy GitHub Pagesworkflow manually.
See docs/superpowers/specs/2026-06-06-omaha-deals-map-design.md and docs/superpowers/plans/2026-06-06-omaha-deals-map.md.