oref-map

April 3, 2026 ยท View on GitHub

Live map of Israel showing Pikud HaOref (Home Front Command) alerts as colored area polygons per location.

Live: https://oref-map.org

Desktop
Desktop
Mobile
Mobile

Features

  • Colored Voronoi area polygons per location โ€” adjacent same-colored areas merge into contiguous zones
  • Timeline slider to scrub through the last ~1โ€“2 hours of alert history
  • Sound alerts โ€” optional audio notifications for new alerts (muted by default, toggle via ๐Ÿ”‡)
  • Click any area to see its alert history
  • About modal โ€” click โ“˜ or the title for info and disclaimer
ColorMeaning
๐Ÿ”ด RedRocket/missile fire
๐ŸŸฃ PurpleDrone/aircraft infiltration
๐ŸŸก YellowEarly warning / preparedness โ€” go near your shelter, sirens may follow
๐ŸŸข GreenEvent ended (fades out after 1 minute)

Development

./web-dev        # start dev server at http://localhost:8788

Requires Node.js and npx (comes with npm). Uses Wrangler to serve web/ and run the API proxy functions locally.

The polygon data file (locations_polygons.json) is not in the repo โ€” ./web-dev downloads it automatically from the live site if missing.

Deploy

Deployed to Cloudflare Pages (static assets + TLV proxy):

./deploy

The fallback Worker (for non-TLV users) is deployed separately:

cd worker && npx wrangler deploy

Structure

web/
  index.html          # single-file map app (all JS/CSS inline)
  cities_geo.json     # location โ†’ [lat, lng] lookup
functions/
  api/
    alerts.js         # proxies live alerts API
    history.js        # proxies history API
    alarms-history.js # proxies extended history API
    analytics.js      # Cloudflare analytics summary for visitor counts
worker/
  src/index.js        # fallback proxy for non-TLV users (placement: azure:israelcentral)
  wrangler.toml       # Worker config with placement and /api2/* route

Contributing

Contributions are welcome! This is a civic project built for anyone in Israel who wants better situational awareness during alerts.

Ways to help:

  • Bug reports โ€” open an issue if something looks wrong
  • Location data โ€” if a polygon is missing or misplaced, open an issue with the location name
  • Features & fixes โ€” PRs are very welcome! Please keep each PR focused on a single feature or fix. For anything beyond a small bug fix, open an issue first so we can discuss the approach before you invest the effort
  • Feature flags โ€” beta/experimental features are gated behind f- URL params (e.g. ?f-log). To add a new flag, check FF.<name> in JS or use the f-gated CSS class for visibility toggling. See CLAUDE.md for details.

To run locally, see the Development section above.

Author

Created by Maor Conforti.

Contributors

Thanks to @uripeer3, @tomerkon, @michalrymland, @ravitzm21, @tomeras91, and @talmiller2 for contributing to this project.

Data

Polls the Oref APIs:

  • Live alerts (/api/alerts) โ€” every 1 second
  • History (/api/history) โ€” every 10 seconds