Stellantis Vehicle Dashboard for Home Assistant
SV Dashboard is a HACS custom integration that builds a vehicle-focused Home Assistant dashboard on top of Stellantis Vehicles.
Beta status: SV Dashboard is the successor to
CaneTLOTW/e_c3_dashboard. The new Home Assistant domain issv_dashboard. Owner live/visual validation has passed through the native Dual-Energy Hero beta cycle; a real DS4 Hybrid/French external validation remains active before promotion tomain.
Install this repository as an Integration, not as a standalone Lovelace-card repository.
While SV Dashboard is distributed only as GitHub prereleases, beta testers should enable the per-repository Pre-release switch for SV Dashboard in HACS. With that switch disabled, HACS can fall back to the repository's develop commit SHA instead of advertising the semantic v0.6.0-beta.N tag.
HACS 2.0.x also currently builds the external update/release link without GitHub's required /tag/ path segment. A 404 from that particular HACS-generated link does not mean the SV Dashboard package failed to install; use the canonical GitHub release page (/releases/tag/<tag>) instead. This upstream behavior is tracked in issue #41.
Once a stable SV Dashboard release exists, normal stable users should not need to enable HACS prereleases.
- Dynamic vehicle discovery from Stellantis Vehicles; no hard-coded VIN entity IDs.
- Multi-vehicle dashboard generation with brand-aware titles.
- Capability-based UI for electric, hybrid and combustion vehicles.
- Electric SOC/range/charging views only when the upstream vehicle exposes those capabilities.
- Fuel/range/consumption views for combustion-capable vehicles when available upstream.
- A compact universal vehicle overview plus a native Dual-Energy vehicle overview for simultaneous battery + fuel presentation.
- Native Hero interactions: vehicle navigation and Home Assistant More Info/history for temperature, battery/fuel percentages and the active detail metric.
- Trip, charging, fuel and GPS history with data-quality guards.
- Long-term statistics for supported mileage/SOH data.
- Optional notifications, recipients, warning thresholds, quiet hours and reachability diagnostics.
- Wake-up/reachability controls with conservative status handling.
- 18 Home Assistant/frontend/backend languages with English fallback.
- No fixed e-C3/DS4 battery-capacity assumption; battery energy is shown only from trustworthy vehicle-specific data or an explicit per-vehicle fallback.
SV Dashboard is designed around the capabilities exposed by the upstream Stellantis Vehicles integration rather than hard-coded model names.
The upstream project currently covers the PSA-side brands:
- Citroën
- Peugeot
- DS Automobiles
- Opel
- Vauxhall
Real-world SV Dashboard validation is intentionally tracked separately from expected upstream compatibility:
| Brand / vehicle | SV status |
|---|---|
| Citroën e-C3 | Confirmed owner validation — EV dashboard and native Hero visual/i18n QA passed |
| DS4 Hybrid | Active external beta — real Hybrid/French/SOH validation by @chmtc94 |
| Peugeot | Expected / upstream-supported — real SV vehicle test pending |
| Opel | Expected / upstream-supported — real SV vehicle test pending |
| Vauxhall | Expected / upstream-supported — real SV vehicle test pending |
Other Stellantis brands are not claimed as supported unless the upstream integration exposes the required vehicle data and SV Dashboard has been validated against it.
See the Vehicle validation guide, the completed migration record and the active DS4 Hybrid beta issue.
SV Dashboard derives a vehicle capability profile from the upstream integration:
- Electric — SOC, electric range, charging, battery/SOH and electric energy metrics when available.
- Hybrid / PHEV — electric and fuel capabilities can appear simultaneously or independently. The Dual-Energy Hero keeps both energy domains visible without inventing unavailable values.
- Thermic / combustion — fuel level, fuel range and fuel-consumption views where available; electric-only charging and battery analytics remain hidden.
- Hydrogen / unknown — handled defensively; only capabilities actually exposed upstream are shown.
For the Dual-Energy Hero, current_trip_energy means absolute energy used during the current trip in kWh. It is not a synthetic kWh/100 km Hero value. While driving, a fuel-consumption value is shown only when the mapped upstream value is numeric and fresh for the current drive; otherwise fuel range remains visible. Package-derived charge power/energy can be battery-side SOC/time estimates and are not EVSE/grid meter readings.
Home Assistant integration UI, package-owned entities, frontend cards and backend messages use the same 18-language matrix:
de, en, fr, it, es, pt, nl, da, nb, sv, fi, pl, cs, sk, hu, ro, sl, hr
English is the fallback language. DE/EN/FR runtime switching of the native Dual-Energy Hero has been visually checked, including long French Hybrid labels. See Localisation.
SV Dashboard exposes two vehicle cards in Home Assistant's normal card picker.
type: custom:sv-dashboard-vehicle-overview-cardThis is the compact reusable vehicle card for another Home Assistant dashboard. With multiple SV Dashboard entries, bind it to the required config entry with entry_id.
type: custom:sv-dashboard-dual-energy-overview-cardThis is the wide native battery + fuel Hero intended especially for Hybrid/PHEV vehicles. It supports idle, driving and charging presentation, native More Info/history targets, mapped preconditioning and automatic localisation.
See Dual-Energy vehicle overview card for DE/EN/FR examples and the exact data/interaction contract.
Advanced users are not limited to the bundled presentation: the mapped Stellantis entities and SV-owned metric entities are normal Home Assistant data sources. A custom Lovelace/YAML prototype plus screenshots can be shared as concrete design input for future package features.
SV Dashboard currently targets Home Assistant 2026.5.0 or later.
Install and configure these dependencies first:
Stellantis Vehicles must already expose a real vehicle. Mileage and tracker data are the universal baseline; battery/fuel/charging entities are capability-specific.
See Installation.
| View | Purpose |
|---|---|
| Vehicle | Current vehicle state, native LIVE/Dual-Energy Hero where applicable, range/energy/fuel state, latest trip/charge and quick actions. |
| Charging | Charging sessions and charge curves when the vehicle exposes charging capabilities. |
| Statistics | Mileage, driven distance, consumption and available SOH/long-term statistics. |
| Trips | Canonical driving history, filters and data-quality handling. |
| GPS | Recorder/server position history plus current vehicle position. |
| Wake-up | Manual and optional reachability controls. |
| Notifications | Recipient controls, thresholds, quiet hours and diagnostics. |
| System | Integration/runtime administration, mapped upstream diagnostics and the opt-in privacy-safe Vehicle API audit. |
Views and cards are capability-gated: unsupported electric or fuel features are not shown merely because another vehicle type provides them.
SV Dashboard is a new Home Assistant integration with the domain sv_dashboard; it is not an in-place rename of e_c3_dashboard.
During the beta phase the recommended migration is:
- keep the old e-C3 Dashboard installation available as reference;
- install SV Dashboard separately;
- configure the same upstream vehicle in SV Dashboard;
- validate dashboard, history and controls;
- remove the old e-C3 Dashboard only after the SV installation is confirmed.
Existing e-C3 Dashboard config entries are not silently rewritten into the new domain. SV Dashboard uses its own stores; available history is fetched/rebuilt independently rather than copying private predecessor storage.
The migration implementation and owner live acceptance are recorded in the now-completed migration issue #1.
Active development happens on develop. External beta testers receive an exact validated commit/pre-release rather than a moving development branch.
CI currently checks:
- Python compilation
- frontend JavaScript syntax
- Node regression tests
- all JSON catalogs
- Home Assistant translation key/placeholder coverage
- 18-language frontend/backend coverage
- SV domain/branding rules
- Hassfest
- HACS repository validation
Promotion to main happens only after the exact candidate has passed CI and the required owner/external live acceptance. The current plan is to wait for the DS4 Hybrid tester feedback before the next develop → main promotion.
SV Dashboard is licensed under GPL-3.0-or-later. See LICENSE.
SV Dashboard is an independent community project and is not affiliated with or endorsed by Stellantis, its brands, Home Assistant or their affiliates. Brand names are used only to describe compatibility/interoperability. See TRADEMARKS.md.
- Installation
- Vehicle validation guide
- Vehicle capability audit
- Community guide
- Concept
- Stellantis API reference and runtime findings
- Dashboard features
- Entity catalog
- Localisation
- Notifications and wake-up
- Vehicle overview card
- Dual-Energy vehicle overview card
- Release checklist
- Branch and deployment workflow
For current compatibility/beta testing, use the Vehicle validation guide and GitHub Discussions once enabled. The completed migration history remains available in issue #1.