PerfectDraft Card
A custom Lovelace card for the PerfectDraft Pro Home Assistant integration. Displays your keg status at a glance — what beer is on tap, its temperature, and how many glasses remain — using a beer emoji pictogram.
Designed and optimised for the Sonoff NSPanel Pro 120 in landscape mode, but works on any HA dashboard.
Features
- Five layouts — landscape, portrait, compact, hero, or single-vessel gauge; choose what fits your dashboard (defaults to landscape, so existing cards are unchanged)
- Beer emoji pictogram — see how many glasses remain in your keg at a glance, in a grid that shrinks to fit narrow cards
- Automatic beer detection — the card reads the tapped keg from the integration and shows the right beer on its own; nothing to select
- Built-in beer catalog — every keg the integration can identify, 68 with real keg photos; brand-tinted fallback art for the rest so every beer looks intentional
- Glass size selector — tap the emoji zone to choose between 250 mL, 330 mL, 500 mL, UK pint, or US pint
- Freshness warnings — escalating CSS-animated alerts as your keg approaches its 30-day expiry
- UI-driven configuration — no YAML editing required; everything is set up through the visual card editor
Requirements
- PerfectDraft Pro integration 0.4.0 or later, installed and configured — the card reads the keg sensors added in that release
- Home Assistant 2024.8 or later
Installation
HACS (recommended)
- Open HACS → Frontend
- Click the three dots menu → Custom repositories
- Add
https://github.com/Falkvinge/hassio-component-perfectdraft-prowith category Dashboard - Search for "PerfectDraft Card" and install it
- Refresh your browser
Manual
- Download
perfectdraft-card.jsfrom the latest release - Copy it to your Home Assistant
config/www/perfectdraft-card/directory - Go to Settings → Dashboards → Resources and add
/local/perfectdraft-card/perfectdraft-card.jsas a JavaScript Module - Refresh your browser
Confirming which version is running
Browsers cache dashboard resources aggressively, so after an update it is worth
checking which bundle actually loaded. The card logs a PERFECTDRAFT-CARD v<version> banner to the browser console on load. If that version is not the one
you installed, hard-reload the page (Ctrl/Cmd + Shift + R) — the card behaviour
you are seeing is the old bundle's, not the new one's.
Configuration
No YAML editing required. Add the card through the HA dashboard UI:
- Edit your dashboard → Add Card → search for "PerfectDraft Card"
- The editor auto-discovers your PerfectDraft device(s)
- Pick your glass size and layout
- Done! The beer is detected automatically from the keg in your machine.
Beer detection
The card identifies the tapped beer from the integration's keg sensors, matching on the keg's product ID first and its reported name second. When no keg is tapped, the card says so rather than showing a beer.
If your keg is not recognised, or is shown as the wrong beer, use Correct the
beer for the keg in the machine in the card editor. The correction is saved
against that keg's product ID (beer_overrides in YAML), so it applies while
that keg is tapped and stops applying when you swap kegs — a correction can
never outlive the keg it was for. The card marks any beer it is showing because
of a correction, so an override is never mistaken for a detection result.
Reports of unrecognised or mis-detected kegs are welcome as issues — the fix is usually a one-line catalog addition, which is better for everyone than a local correction.
Upgrading from 0.3.x or earlier
beer_name is no longer supported and is ignored when present. Versions before
0.3.0 required it — the editor always wrote it and new cards were seeded with
it — and 0.3.1 then treated those leftover values as permanent overrides, which
made cards show a beer that was no longer in the machine. Ignoring the key
returns those cards to auto-detection. No automatic migration is possible,
because the old value records no product ID; re-apply the correction from the
editor if you still need it.
YAML reference (for power users)
type: custom:perfectdraft-card
device_id: "perfectdraft_pro"
glass_size: 330
layout: landscape # landscape | portrait | compact | hero | vessel
# matrix_columns: auto # "auto" or a fixed number of emoji columns
# max_matrix_width: "480px" # cap + centre the emoji grid on wide cards
# beer_overrides: # corrections keyed by keg product ID; normally unset
# "1095": "Leffe Ruby" # applies only while that keg is tapped
# custom_beers:
# - name: "My Homebrew IPA"
# brewery: "Home"
# color_primary: "#4A7C2E"
# color_secondary: "#F0F7E8"
# image_url: "/local/images/my-ipa.png"
On-card interactions
| Action | What happens |
|---|---|
| Tap the right zone (emoji grid) | Opens glass size selection dialog |
The beer is detected rather than chosen, so the label zone is display-only. Your glass size choice persists in your browser across page refreshes.
Layouts
Set layout (or pick it in the visual editor) to match where the card lives:
| Layout | Best for |
|---|---|
landscape (default) |
Wall panels (NSPanel Pro), wide cards — label left, emoji grid right |
portrait |
Phones and tall/narrow columns — label on top, grid below |
compact |
Dense dashboards — a single row with a remaining-beer bar |
hero |
Showing off the beer — full-bleed keg photo with status overlaid |
vessel |
A calm single glass that fills to show how much is left |
The emoji grid is width-tolerant: it shrinks to fit narrow cards instead of overflowing. Power users can force a column count with matrix_columns or cap/centre the grid with max_matrix_width.
Supported glass sizes
| Size | Description |
|---|---|
| 250 mL | Small glass |
| 330 mL | Bottle / standard |
| 500 mL | Half litre |
| 568 mL | Pint (UK) |
| 473 mL | Pint (US) |
Sensor entities used
The card reads these sensors from the PerfectDraft integration:
| Sensor | Used for |
|---|---|
*_temperature |
Beer temperature display |
*_keg_remaining |
Glasses remaining calculation |
*_keg_freshness |
Freshness warning system |
*_keg_product |
Identifying the tapped beer (product ID match) |
*_keg |
Identifying the tapped beer (name match fallback) |
The last two arrive with integration 0.4.0. If they are missing, the card tells you to update the integration instead of guessing at a beer.
License
This project was AI-generated. Human involvement did not meet the bar for substantial originality required for copyright protection. This work is in the public domain where applicable, or otherwise not subject to copyright protection.
