hawaii-eats
Three things built from one pipeline (modeled on ../id-eats/, ../wi-eats/ and ../co-eats/, which are never modified):
- The web leaderboard: every Hawaii restaurant ranked on several boards, published as a private claude.ai Artifact from
site/
(generated by scripts/make-leaderboard.py). It uses the UCSD Google Local 2021 snapshot for ratings, labeled "2021" everywhere, so
site/ never goes in a public repo.
- Hawaiʻi Eats: Restaurants, a free iPhone and iPad app (
HawaiiEats/, XcodeGen project.yml). No Google-derived data: places come
from Overture Maps open data, island coastlines and town spellings from the Hawaii Statewide GIS Program and USGS; ratings and hours come
live from Apple Maps' own place card.
- The website in
docs/ (generated by scripts/make-site.py): landing page, the hand-checked guides, the James Beard honorees, town
and island pages, what Hawaii's green, yellow and red health placards mean, the web app at /explore/, privacy and terms. QA with
scripts/qa-site.py.
See CLAUDE.md for the rules and commands, and playbook/ for sources and calibration (12-sources.md) and the naming round
(05-naming.md).
Official records
- Hawaii State Department of Health, Food Safety Branch: inspects every food business on every island and posts a color-coded placard
(HAR 11-50). It publishes results one search at a time, so there are no inspection results here; each place links DOH's page.
- DOH food permit lists (2011 statewide, 2013 Oʻahu, opendata.hawaii.gov): history notes and calibration only. Permit holders' names
and phone numbers are never shown.
- Liquor licenses are county-run and no list is readable automatically, so "serves alcohol" is unknown for now.
- James Beard Foundation honors and America's Classics, as facts. Hawaii has no MICHELIN Guide.
Hand-checked research
data/research/ (private): plate lunch and drive-ins, poke, saimin, shave ice, malasadas and bakeries, Hawaiian food and okazuya, musubi,
loco moco, Lahaina places open again after the 2023 fire, and the oldest places, each with a 2025–26 source.
