v0.1.3 — generic card-picker preview name

The card picker preview no longer displays the name of whichever real PM2.5 sensor the stub config happened to grab — it now shows a generic "Air Quality" title until you configure the card.

v0.1.2 — docs, screenshots & Open in HACS button

Documentation and packaging polish. No functional changes to the integration or sensors since v0.1.1.

Added

• Full README rewrite with per-category card screenshots (Good → Hazardous), a features breakdown, step-by-step install, card options, methodology notes, and a "preview each state via Developer Tools" guide.
• "Open in HACS" button — a My Home Assistant redirect badge that opens your Home Assistant with this repository pre-filled in HACS for a one-click download.

Included since v0.1.1

• Static landscape (tree sway animation removed); drifting clouds and bobbing mascot retained.

Install

After updating the card via HACS, hard-refresh your browser (Cmd/Ctrl+Shift+R) once to load the new JS.

Air quality data by AirGradient under CC BY-SA 4.0.

v0.1.1 — calmer scene

Removed the tree sway animation for a calmer, more static landscape. The drifting clouds and gently bobbing mascot are unchanged. No integration/sensor changes.

Note: after HACS updates the card, hard-refresh your browser (Cmd/Ctrl+Shift+R) once to load the new JS.

v0.1.0 — first release

First release of AirGradient Public Location — follow any public sensor from the AirGradient map in Home Assistant, no account or API token needed.

What's included

• Integration (airgradient_public): UI config flow (enter a public location ID), token-free cloud polling of the AirGradient public API. Creates sensors for PM2.5, PM10, PM1, US AQI (computed from EPA breakpoints), CO₂, temperature, humidity, TVOC index, NOx index, plus optional PM0.3 count and Wi-Fi diagnostics. Long-term statistics enabled.
• Lovelace card (custom:airgradient-map-card): bundled and auto-loaded — no separate resource setup. Compact animated scene whose colours and mascot mood follow the US EPA PM2.5 category; tap to expand into a 24-hour chart, 12h/24h averages, WHO annual-guideline comparison, cigarette equivalent, and a 10-days-by-hour heatmap. History is built from Home Assistant's own recorder, so charts fill in over the first hours/days.

Install

HACS → Custom repositories → add this repo as Integration → install → restart HA → add the integration with a public location ID.

Air quality data by AirGradient under CC BY-SA 4.0. Card artwork is original; not affiliated with AirGradient.