Our take
- Activity
- 35
- Community
- 63
- Issues
- 50
- Pull requests
- 82
+15 stars in the last 30 days
- Merges more pull requests than 92% of the projects we track
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
3,919Forks
278Change since Nov 20, 2026: +1 stars·0 forks
Overview
mini-graph-card is a custom card for Home Assistant’s Lovelace dashboards. It turns sensor and binary sensor readings into compact line or bar graphs, while optionally showing current values, names, and other context in the same card.
It is useful when a dashboard needs quick visibility into recent trends without dedicating space to a larger chart. Configuration supports single or multiple entities and controls for time range, aggregation, colors, axes, and display elements.
Key Features
- Plots history for sensor and binary sensor entities as line or bar graphs.
- Displays current states, names, legends, and optional averages or extrema.
- Configures history range, point density, grouping, and aggregation functions.
- Customizes graph colors, including threshold-based color changes.
- Supports multiple entities, secondary axes, and per-entity display options.
- Maps non-numeric states to labels and can read nested entity attributes.
- Offers HACS, manual, and CLI installation paths.
Use Cases
- Home Assistant users can monitor recent temperature, humidity, or energy trends in a compact dashboard.
- Household members can compare several sensor readings in one card, such as indoor conditions across rooms.
- Energy-focused dashboards can group readings by date and display daily values as bars.
- Users can show binary sensor activity over time by mapping states such as
onandoffto labels.
Getting Started
Install through HACS or follow the manual installation instructions in the README. For a minimal YAML card, add the installed resource to Lovelace and configure an entity:
type: custom:mini-graph-card
entities:
- sensor.illumination
See the README for resource setup, additional configuration, and examples.
Considerations
- This is a custom Lovelace frontend card, not a standalone application. It requires a working Home Assistant dashboard and sensor entities.
- The card displays recorded history, so available data and its granularity depend on Home Assistant history and the card’s configuration.
- Installation requires adding the JavaScript module as a Lovelace resource. Browser caching may need to be cleared after updates.
- The repository documents development with Node.js and npm; typical dashboard users can install a release without building from source.
Found this useful?
Share it with someone who would like mini-graph-card.