hawaii-eats

Three things built from one pipeline (modeled on ../id-eats/, ../wi-eats/ and ../co-eats/, which are never modified):

1. 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.
2. 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.
3. 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.