⚠️ Alpha cut from the
nws-alertsbranch — not yet merged to main.
Two new US-only data overlays with strong life-safety disclaimers. Read the README warnings before relying on this for anything that matters.
This 3.5.0 alpha is for soak-testing the new wildfire and NWS alerts overlays, plus supporting UX and performance work, on top of v3.4.0-beta.
⚠️ Life-safety disclaimer
Both new overlays are informational only and not a substitute for official notification systems (Wireless Emergency Alerts, NOAA Weather Radio, local emergency management, official evacuation orders). Data may be delayed, incomplete, or inaccurate. See the README's > [!CAUTION] and > [!WARNING] callouts before using.
New overlays
-
Wildfires (US-only) — active US wildfire perimeters from NIFC's WFIGS feed. Active fires red, contained ones grey. Small incidents render as a fire icon, larger as a polygon. Click any fire for name, acreage, containment %, discovery date, and an InciWeb link (gated against InciWeb's RSS index so we don't link to 404s). Adaptive 5/30-minute refresh.
-
NWS watches & warnings (US-only) — active US National Weather Service alerts from
api.weather.gov/alerts/active. Polygons coloured per NWS's standard warning palette. Both polygon-bearing AND zone-based alerts render — zone shapes are fetched on-demand and cached in localStorage (TTL 30 days) so they're zero-network on subsequent sessions. Click any alert for event, headline, severity, effective/expiry, full description with line breaks, and a weather.gov link. -
Hazard Overlays editor subpage — new "Markers and Overlays" section in the editor groups two nav rows: Markers (existing) and Hazard Overlays (new). The subpage exposes wildfire / alerts toggles, per-overlay knobs (acreage, radius, severity), and a 2-column grid of NWS alert-category checkboxes (Tornado, Thunderstorm, Flood, Winter, Tropical, Fire Weather, Heat, Wind, Marine, Other; marine off by default).
UX improvements
- WYSIWYG map editing — when this card's edit dialog is open, every pan/zoom in the live map auto-propagates to the editor's Lat/Long/Zoom fields in real time. The "Save as map center" button is gone.
- Build timestamp in console signon — confirms a hard refresh actually loaded the new bundle vs a cached older one.
- Region-warning banner — surfaces a single combined banner when any US-only feature is enabled with
hass.config.country !== 'US'.
Performance
- Shared rate limiters — per-source (RainViewer 500/min, NOAA 120/min, DWD 500/min) are now module-level singletons. Survive card teardown (config edits no longer reset the count) and shared across multiple weather-radar-cards on the same dashboard.
- Pause when hidden — wildfire and alerts layers stop their refresh timers when the card scrolls off-screen or the tab is hidden, refetch on resume if stale.
- Dynamic radar tile size — picks 256/512/1024/2048 from
map.getSize()so panel-view / fullscreen maps load with bigger tiles. Confirmed empirically to noticeably cut load time and rate-limit hits on larger maps.
Tests
128 → 223 unit tests (95 added). New coverage: geo helpers, string helpers (incl. XSS escape patterns), NWS alert categories (regression guard for the empty-array bug), colour table, region-warning composition, alert-layer helpers including the localStorage zone cache (round-trip, TTL eviction, corrupt JSON, quota-exceeded handling).
Localization
11 language files updated for the new editor strings. Coverage 92–99% per language; brand acronyms (NWS, NOAA, NIFC, README) intentionally retained.
Testing the alpha
Install via HACS (toggle "Show beta versions") or by manually copying dist/weather-radar-card.js into /config/www/community/weather-radar-card/.
Things to look for:
- US users: confirm wildfires + alerts render correctly in your area; tap on a fire / alert and check the popup.
- Outside US: confirm the region-warning banner appears, and that the overlays don't try to load.
- Anyone: confirm the Hazard Overlays subpage works (toggle on/off, change categories, change min severity). Confirm WYSIWYG map editing — pan/zoom while editing and watch the Lat/Long fields update.
- Performance: card in panel view should noticeably feel faster to load now.
Bug reports → issues.