A custom Lovelace card that displays per-panel solar production from a SunPower PVS6 system, with color-coded status tiles, historical production charts, drag-to-arrange layout, and a detail popup for each panel.
- Per-panel monitoring — live wattage, today's kWh, and temperature for each inverter
- Color-coded tiles — grey (offline) → amber → orange (peak production)
- Sparkline graphs — today's production curve on every tile
- Detail popup — click any panel for full metrics: MPPT voltage/amps, frequency, voltage, amps
- Production history charts — Day / Week / Month / Year / Lifetime / Custom range
- Period navigation — ← → arrows to browse previous days, weeks, months, years
- Hover tooltips — hover over any bar to see exact kWh for that period
- Roof layout arrange — drag panels to match their physical position on your roof
- Persistent layout — arrangement saved to HA server, survives browser cache clears
- Snap-to-grid — click a panel to select it, click any slot to move it
- Auto-extending grid — empty rows appear automatically for flexible layouts
- Offline detection — red pulsing dot for unavailable/disconnected panels
- Scroll-safe — uses smart re-render to prevent page scroll reset on data updates
- SunPower PVS6 supervisor (one microinverter per panel)
- Enhanced SunPower —
smcneece/ha-esunpower- This integration creates one device per inverter with entities for Power, Lifetime Power, Temperature, Voltage, Amps, MPPT data, etc.
The card auto-detects inverters matching:
sensor.inverter_<SERIAL>_power
Where <SERIAL> is any alphanumeric string with no underscores. Examples:
sensor.inverter_e00122251088861_power # SunPower E-series (14 digit)
sensor.inverter_A12345678_power # Other serial formats
sensor.inverter_ZZ9876543210_power # Any length, any prefix
If your entities follow this pattern, the card works with zero configuration.
Download sunpower-panel-card.js from this repository and place it in:
config/www/sunpower-panel-card.js
Using the HA File Editor add-on: navigate to /config/www/ and upload the file. If the www folder doesn't exist, create it first.
Go to Settings → Dashboards → ⋮ (three dots top right) → Resources → Add Resource
| Field | Value |
|---|---|
| URL | /local/sunpower-panel-card.js?v=1 |
| Resource type | JavaScript Module |
Then restart Home Assistant (Settings → System → Restart).
Important: Every time you update the card file, increment the
?v=number (e.g.?v=2,?v=3) to force browsers to load the new version.
Edit any dashboard → Add Card → Manual and paste:
type: custom:sunpower-panel-card
title: Solar Panels
columns: 4
max_watts: 400The card will auto-detect all your inverter entities and display them immediately.
| Option | Type | Default | Description |
|---|---|---|---|
title |
string | Solar Panels |
Card title displayed in the header |
columns |
number | 4 |
Number of panel columns (match your widest roof row) |
max_watts |
number | 400 |
Rated capacity per panel in watts (check your spec sheet) |
type: custom:sunpower-panel-card
title: My Solar Array
columns: 4
max_watts: 420The card shows all panels as tiles with:
- Serial number (last 10 digits) in the top-left
- Current wattage in large text
- Production bar showing % of rated capacity
- Sparkline of today's production curve
- Today's kWh accumulated production
- Temperature in °F
Header chips always show:
X/X online— active panels vs totalX.XX kW now— current total system output↑ XX.XX kWh today— today's total production across all panels
Click any panel tile to open a detail sheet with:
- Full inverter serial number
- Current wattage, period total, and online/offline status
- Temperature, MPPT Voltage, MPPT Amps, Voltage, Amps, Frequency
- Production history chart for the selected time range
- Period selector: Day / Week / Month / Year / Lifetime / Custom
- ← → navigation to browse previous periods
- Hover over any bar to see exact kWh for that time bucket
- Tap the overlay background or ✕ button to close
Click ⠿ Arrange in the top-right corner to enter arrange mode.
How to move panels:
- Click a panel tile — it gets an orange outline (selected)
- Click any other panel or empty slot — the selected panel moves there (swap)
- Empty rows auto-extend as you move panels downward
- Click ✓ Done to save the arrangement
Reset — click the red ↺ Reset button at the bottom of the arrange view to restore the default serial-sorted order.
Layout persistence — your arrangement is saved to HA's server storage and survives:
- Browser cache clears
- Hard refreshes
- Different browsers on the same HA account
- HA restarts
| Period | Bars represent | Navigation |
|---|---|---|
| Day | kWh per hour (24 bars) | ← previous day / → next day |
| Week | kWh per day (7 bars, Sun–Sat) | ← previous week |
| Month | kWh per day (28–31 bars) | ← previous month |
| Year | kWh per month (12 bars) | ← previous year |
| Lifetime | kWh per year (up to 15 years) | No navigation |
| Custom | kWh per day (date range picker) | Select start and end dates |
Note: Week/Month/Year/Lifetime data comes from HA's long-term statistics — available from when Enhanced SunPower was first installed, not limited by recorder retention.
The card shows "No inverters found" — check that:
- Enhanced SunPower integration is installed and configured
- Your inverter entities follow the pattern
sensor.inverter_E<14digits>_power - At least one inverter entity is in state
onor reporting a numeric value
Open the browser console and look for:
SunPower Panel Card v3.9.2 — 19 inverters
If you see 0 inverters, your entity IDs don't match the expected pattern.
Change the resource URL version number: /local/sunpower-panel-card.js?v=2 → ?v=3
Then go to Settings → System → Restart for a full HA restart, followed by a hard browser refresh (Ctrl+Shift+R).
This should not happen with v3.9.2+ — the layout is stored in HA's server. If it does reset, click Arrange and re-save to write the arrangement to HA's storage.
- Week/Month/Year use HA's long-term statistics recorder. These are created automatically once Enhanced SunPower is installed and HA has been running for some time.
- The Lifetime view shows up to 15 years of monthly averages.
- If you see no bars for week/month, wait 24–48 hours after installing Enhanced SunPower — HA needs time to accumulate statistics.
The Enhanced SunPower integration reports power in kW — the card converts to W automatically. If values look 1000× too small or too large, check your max_watts setting matches your panel's rated capacity.
Tested with:
- SunPower PVS6 supervisor
- AC Module Type H microinverters (one per panel)
Should work with any SunPower system where Enhanced SunPower creates entities in the sensor.inverter_E<serial>_power format.
These were also used in the author's setup alongside this card:
| Name | Purpose |
|---|---|
| Enhanced SunPower | Per-inverter entity data |
| Solcast PV Forecast | Solar production forecast |
| Power Flow Card Plus | System-level energy flow visualization |
| ApexCharts Card | Advanced charting for system totals |
| Version | Highlights |
|---|---|
| 3.9.3 | Flexible serial detection — any format between inverter_ and _power |
| 3.9.2 | HA server storage for layout persistence — survives all browser clears |
| 3.9.0 | IndexedDB persistence (superseded by 3.9.2) |
| 3.8.0 | slot_grid config field approach (superseded) |
| 3.7.0 | Detail panel moved to bottom-sheet modal popup |
| 3.5.0 | kWh production charts replacing avg-watt charts |
| 3.4.0 | Y-axis labels on production chart |
| 3.3.0 | Snap-to-grid arrange with auto-extending empty rows |
| 3.0.0 | Full snap-to-grid rewrite, localStorage + config persistence |
| 2.0.0 | HA statistics WebSocket API, period navigation, custom range |
| 1.4.0 | Light theme, 24h timeline, period history buttons |
| 1.0.0 | Initial release |
MIT License — free to use, modify, and share.
Built for a SunPower residential solar installation in Prosper, Texas. Developed iteratively with real inverter data from a PVS6 system with 19 AC Module Type H panels.