36 Commits
Author SHA1 Message Date
rick 27764b5d75 Merge agent/add-oktoberfest-keg-art: Oktoberfestbier keg artwork, v0.4.5 2026-11-07 12:37:16 +01:00
rickandCursor a79173a160 Keg artwork for Löwenbräu and Spaten Oktoberfestbier; version 0.4.5
Both entries were mapped by kegId (29745, 33918) but had no imagePath, so the card drew the generated silhouette. Images come from the PerfectDraft DE storefront, encoded to WebP like the existing art (800 px and the native 700 px). The reference snapshot is re-synced to integration commit 1598e7b0, which spells 29745 as Löwenbräu Oktoberfestbier. Issue #8 on the integration repo.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-11-07 12:35:16 +01:00
rick e56f27a49a Merge agent/add-keg-48180: Camden Stout (48180) with keg artwork, v0.4.4 2026-11-07 12:23:57 +01:00
rickandCursor 73a814e266 Version 0.4.4, in step with the integration
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-11-07 12:12:44 +01:00
47ecbe1880 Add Camden Stout (48180) with keg artwork; release 0.4.3
Maps integration product ID 48180 to a camden-stout entry next to the
other Camden rows. Artwork is taken unchanged from card PR #2; ABV 4.0%
checked against Camden Town Brewery's own PerfectDraft listing. The
reference snapshot is re-synced to the integration commit that adds the
key (8b2c4418), and the stale lockfile is regenerated.

Co-authored-by: MThomas564 <mattraethomas97@gmail.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-11-07 12:08:48 +01:00
rickandCursor 788ae28c44 Map keg 47792 to Camden Eazy, reusing the existing keg artwork.
Product 47629 stays on the original Camden Eazy entry. The new row shares that graphic.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-26 07:16:34 +02:00
rickandCursor 203d0fd228 Map keg 48050 to the existing Anheuser-Busch Bud catalog entry
The card already had the DE/AT wrap and artwork; the integration now
reports that product ID, so the join can complete. Bump to 0.4.1.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-17 12:42:55 +02:00
rick 542c7599ab Merge branch 'chore/archive-scoped-beer-override' — archive v0.4.0 change, sync specs 2026-09-16 14:24:03 +02:00
rickandCursor d43f1d675d Archive scoped-beer-override and sync its specs
Applies the change's delta specs to the main specs and files the change
under openspec/changes/archive/2026-09-16-scoped-beer-override.

keg-auto-detection gains the scoped-override and override-visibility
requirements, and its detection precedence is rewritten so no config
value can precede detection except by matching the reported product ID.
card-config drops the beer_name override requirement in favour of the
beer_overrides map, and records beer_name alongside beer_entity as an
ignored legacy key.

Also corrects three stale beer_name references in beer-catalog and
beer-label. The proposal's capability list missed those two specs; the
substance of their requirements is unchanged, only the key name they
name, so this is a naming correction rather than a requirement change.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-16 14:23:58 +02:00
rick e8977143c5 Merge branch 'impl/scoped-beer-override' — v0.4.0: keg-scoped beer overrides
The global beer_name override is replaced by beer_overrides keyed by the
product ID it corrects, so a correction cannot outlive its keg. beer_name
is ignored, which returns every card configured before 0.3.0 to
auto-detection. An applied override is marked on the card.
2026-09-16 14:05:57 +02:00
rickandCursor 30138df1a5 Bind the beer override to the keg it corrects (v0.4.0)
Replaces the global beer_name override with beer_overrides, a map keyed
by the product ID the integration reports. An entry applies only while
that keg is tapped, so a correction retires itself on a keg swap — which
matters because a card cannot rewrite its own config and so could never
prune a stale entry.

beer_name is now ignored, joining beer_entity. That is what fixes the
reported symptom: cards configured before 0.3.0 all carry the key,
because the editor of that era always wrote it and getStubConfig seeded
it, and 0.3.1 promoted those dormant values into permanent overrides.
No migration is possible, since the old value records no product ID.

An applied override is now marked on the card with the name detection
resolved, so it can never be mistaken for a detection result. The editor
records corrections against the currently tapped keg and lists saved
entries so leftovers are visible and removable.

Verified against the built bundle in a browser with stubbed hass data:
the reported case, the keg-swap recurrence, unrecognised IDs, the no-keg
state, all five layouts, and a 0.4.0 config loading on the 0.3.1 bundle.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-16 13:39:45 +02:00
rickandCursor 16ea0267d7 Propose scoped-beer-override: bind the manual override to the keg it corrects
The beer_name override reinstated in 0.3.1 has no link to the keg it
corrects, so it outlives it. Every card configured before 0.3.0 carries
the key (the editor of that era always wrote it, getStubConfig seeded
it), which 0.3.1 promoted into a silent permanent override — reported as
a card showing Leffe Blonde while the machine reported Leffe Ruby. The
same failure recurs on any keg swap even without legacy config.

Proposes beer_overrides keyed by product ID, so a correction expires
structurally rather than needing a write the card cannot make, plus a
visible marker when an override is applied. beer_name joins beer_entity
as an ignored key.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-16 12:15:39 +02:00
rick 4a879e84bd Merge branch 'chore/openspec-housekeeping' — consolidate OpenSpec main specs
Syncs all three changes into openspec/specs/ and archives them. No card
behaviour change; documentation and spec hygiene only.
2026-09-09 19:01:35 +02:00
rickandCursor 01b4247cf3 Sync all changes to main specs and archive them
openspec/specs/ had been empty since the project started: all three changes
were left active and unsynced, so there was no consolidated statement of how
the card is meant to behave.

Synced in dependency order -- perfectdraft-card, then card-layouts-and-imagery,
then auto-detect-gap-closure -- so the MODIFIED and REMOVED operations in the
last one had the base requirements they refer to. Result is 10 capability
specs holding 57 requirements, all validating.

Fixed a contradiction the merge exposed: card-layouts still required a beer
selection dialog reachable from every layout, which auto-detect-gap-closure
had removed. Its interaction scenario now covers the glass dialog only, plus
a scenario tying beer display to the keg-auto-detection rules.

Note the archived tasks.md files retain their unchecked items -- the three
hardware verification tasks in auto-detect-gap-closure, and pre-existing
incomplete tasks in the two older changes.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-09 19:01:35 +02:00
rick 74b5e36ef1 Merge branch 'impl/auto-detect-gap-closure' — v0.3.1: full keg ID coverage, honest detection fallbacks
Completes the auto-detection work started in PR #1 by @brettjenkins.

Catalog covers all 114 product IDs the integration can report (was 57),
unlocking 20 keg photos that already shipped but were unreachable. Detection
precedence is explicit, the Leffe Blonde fallback is gone, and beer_name
returns as an optional override. Adds npm run check:catalog to catch upstream
catalog drift.
2026-09-09 17:53:46 +02:00
rickandCursor 45f1e6f394 Release 0.3.1
Patch bump covering the device-change entity invalidation fix on top of the
0.3.0 auto-detection work.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-09 17:53:02 +02:00
rickandCursor 1452620f0a Invalidate resolved entities when the configured device changes
setConfig cached entity IDs for the first device it saw and never cleared
them, so picking a different device in the editor left the card reading the
previous device's sensors. Pre-existing, but _resolveEntities now stops
scanning once the full set is found, which made it easier to hit.

Surfaced by review of the auto-detect-gap-closure changes.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-09 17:49:08 +02:00
rickandCursor 1d0c014111 Close the auto-detection gaps: full keg ID coverage, honest fallbacks
Implements openspec/changes/auto-detect-gap-closure.

Catalog now covers all 114 product IDs the integration can report (was 57).
22 IDs mapped onto existing entries, unlocking 20 keg photos that already
shipped but were unreachable; 36 new entries added for beers the card did
not know. Product ID 48061 was mapped to the wrong beer -- it is Northern
Monk Faith, not A Little Faith -- so it now has its own entry.

Detection precedence is explicit: beer_name override, then product ID, then
reported keg name, then an honest no-keg state. Removes the fallback that
displayed Leffe Blonde whenever detection failed, and prefers the card's
curated name over the integration's product-listing name (12 labels).

beer_name returns as an optional override, empty by default, which also
un-orphans custom_beers. Cards on integrations without the keg sensors now
get told to update rather than shown a wrong beer. _resolveEntities no
longer latches on temperature alone.

Adds npm run check:catalog to catch upstream catalog drift, the root cause
of the original gap.

Hardware verification (tasks 8.1-8.3) still outstanding.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-09 17:04:39 +02:00
rickandCursor 2d3c5c0faf Propose auto-detect-gap-closure: complete keg ID coverage and fix detection fallbacks
Follow-up to PR #1 (d0748e7), which landed auto-detection but covers only
57 of the integration's 114 product IDs and falls back to displaying Leffe
Blonde when detection fails.

Artifacts: proposal, design, four capability specs (keg-auto-detection
new; beer-catalog, beer-label, card-config modified), tasks. Includes a
hand-verified product ID mapping for all 57 unmapped kegs.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-09 16:50:44 +02:00
Rick FalkvingeandGitHub d0748e7e4f Merge PR #1: auto-detect the tapped beer from the PerfectDraft integration
Consumes the keg_product_id/keg_name sensors added in integration PR #2. Gaps in catalog coverage, label preference, and docs are tracked in the follow-up OpenSpec change 'auto-detect-gap-closure'.
2026-09-09 16:43:35 +02:00
Brett Jenkins 672a41a5df Auto-detect the tapped beer from the PerfectDraft integration
Matches the tapped keg against the integration's product-id sensor
first, falling back to name matching. Adds product-id mappings plus a
Bass catalog entry, and removes the now-redundant manual beer picker
and beer_entity/beer_name config options.
2026-07-05 00:50:41 +01:00
rick b28aa89404 Merge branch 'impl/card-layouts-and-imagery' — v0.2.0: layouts, fallback art, +16 keg images 2026-06-01 21:11:06 +02:00
rickandCursor a2319363d6 Add selectable layouts, tiered fallback art, 16 keg images (v0.2.0)
- Five layouts selectable via `layout` config + editor dropdown:
  landscape (default, unchanged), portrait, compact, hero, vessel
- Width-tolerant emoji matrix: shrinks to fit narrow cards instead of
  overflowing (min-width:0, container-query emoji sizing, min_columns:1).
  Fixes the reported crop on narrow placements.
- New matrix knobs: `matrix_columns` (auto|N) and `max_matrix_width`
- Tiered visual fallback so every beer looks intentional:
  keg photo -> brewery logo -> generated palette-tinted keg silhouette
- 16 new keg photos sourced from regional PerfectDraft stores
  (BrewDog, Tiny Rebel, Thornbridge, Fuller's, Theakston, Peroni,
   Diebels, Haake-Beck, La Virgen, Stella Unfiltered, Bud Light,
   Tennent's, Leffe Ambrée, Hertog Jan Grand, Castelain Ch'ti)
- All keg images re-encoded to WebP @ <=800px: dist/kegs 19MB -> 2.1MB
- OpenSpec change: card-layouts-and-imagery (proposal/design/specs/tasks)

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-01 21:09:25 +02:00
rick 5adce69c23 Merge branch 'impl/perfectdraft-card' — v0.1.6 with 31 new keg images 2026-04-18 20:31:16 +02:00
rick c086437ce5 Add 31 real keg images, 2 new beers, image fallback (v0.1.6)
- Wire imagePath for 31 newly downloaded keg product images
- Add Castelain Ch'ti Blonde and Hertog Jan Grand Pilsener entries
- Add onerror fallback on <img> to show letter initial if image fails
- Remove 18 stale placeholder images from dist/kegs/
- Bump CARD_VERSION, EDITOR_VERSION, and package.json to 0.1.6

Made-with: Cursor
2026-04-18 20:31:04 +02:00
rick 571d2837f6 Add agent handoff notes for next session
Made-with: Cursor
2026-04-18 20:16:38 +02:00
rick a53485a927 Merge branch 'impl/perfectdraft-card' 2026-04-18 19:59:09 +02:00
rick 3d8344b9bf Add screenshot to README
Made-with: Cursor
2026-04-18 19:59:04 +02:00
rick ffe8006840 Merge branch 'impl/perfectdraft-card' 2026-04-18 19:56:58 +02:00
rick 2134576537 Remove 51 placeholder images, keep 21 real keg photos (v0.1.5)
64 of 72 images were CDN placeholder JPEGs (10KB each) disguised
as PNGs. Replaced 8 originals with full-resolution versions and
found 13 additional real images using alternate CDN filenames.

Beers without images now fall back to color palette display instead
of showing a broken "Awaiting Image" placeholder.

21 beers with real product images, remainder use brand colors.

Made-with: Cursor
2026-04-18 19:56:52 +02:00
rick a44f5ab9cf Merge branch 'impl/perfectdraft-card' 2026-04-18 19:46:08 +02:00
rick d1b64fd9c7 Emoji grid fills zone: stretch rows, bigger emojis (v0.1.4)
- Grid rows use 1fr to stretch vertically across full zone height
- Each glass is a flex container filling its grid cell
- Emoji font-size: min(7vw, 5em) — roughly 150% of previous
- Grid align-content: stretch instead of center

Made-with: Cursor
2026-04-18 19:45:56 +02:00
rick 7493721d4a Merge branch 'impl/perfectdraft-card' 2026-04-18 19:34:54 +02:00
rick 6de5f6a960 Scale up elements, label zone to ~1/4 width (v0.1.3)
- Label zone: 1/4 width (was 1/3), keg zone gets 3/4
- Beer logo: flex-grows to fill space, 80% width
- Temperature: 3em, beer name: 1.6em, count label: 1.3em
- Emoji grid: min(4.5vw, 3.5em) auto-scales to fill zone
- All elements sized up for NSPanel Pro readability

Made-with: Cursor
2026-04-18 19:34:47 +02:00
rick 42147366ae Merge branch 'impl/perfectdraft-card' 2026-04-18 19:07:50 +02:00
rick 63be469bb2 Emoji grid with fixed slots, Leffe Noël alias (v0.1.2)
- Emoji grid now uses CSS Grid with fixed max-glass slots per size
  (e.g., 6x3 for 330mL). Empty slots shown as faded greyed-out emojis.
- Added Leffe Noël as alias for Leffe Winter (same beer, French name)
- Bumped editor version to 0.1.2

Made-with: Cursor
2026-04-18 19:07:44 +02:00
342 changed files with 4220 additions and 427 deletions
+72
View File
@@ -0,0 +1,72 @@
# Agent Handoff — PerfectDraft Card
## Current State (2026-04-18)
The PerfectDraft Card custom Lovelace card is working and deployed on a Sonoff NSPanel Pro 120 in landscape mode. Current release is **v0.1.5** on GitHub via HACS.
## What's Done
- Full card implementation: two-zone layout (beer label left ~1/4, emoji grid right ~3/4)
- 72-beer catalog with brand color palettes
- 21 real keg product images (full resolution from PerfectDraft CDN)
- CSS Grid emoji layout with fixed slots (6×3 for 330mL, etc.)
- Glass size selection dialog (250/330/500/UK pint/US pint)
- Beer selection dialog with search
- Freshness warning system (CSS-only, 4 tiers)
- Visual card editor with HA device registry auto-discovery
- HACS-compatible, deployed via GitHub releases
- Screenshot in both repos' READMEs
- Editor version marker for debugging
## What Needs Doing Next (Immediate)
### 1. Add 31 newly downloaded beer images to catalog
**31 new keg images** were downloaded from the PerfectDraft store DOM and are sitting in:
```
.worktree/perfectdraft-card/src/assets/kegs/
```
These need to be wired into `src/beer-catalog.ts` by adding `imagePath: kegImage("slug")` to each beer entry that now has an image file. The beers that gained images are:
leffe-dete, hoegaarden, stella-artois-0, leffe-0, kwak, dupont, san-miguel, fruh-kolsch, castelain, lowenbrau, schneider, hasseroder, camden-pale, camden-hells, camden-ipa, camden-eazy, becks, trooper, northern-monk, st-austell, old-speckled-hen, anoesteke, vocation-hop-skip, vocation-life-death, franziskaner-royal, saint-feuillien, leffe-prestige, leffe-brune, hoegaarden-rosee, rousse-mont-blanc, ninkasi
Also discovered from the DOM:
- **New beers to add to catalog**: Castelain Ch'ti Blonde (slug: `castelain-chti`), Hertog Jan Grand Pilsener (slug: `hertog-jan-grand`), Anheuser-Busch Bud uses filename `keg-abb_2x.png` (already have as `bud.png`)
- **Leffe d'Été** image filename is `keg--leffe-summer-e_te__2x.png` (not `keg--leffe_d_ete`)
- **Haake-Beck** image is a JPG (`haake_beck.jpg`) at `/h/a/` path — the cached version is too small (9KB). May need to find from UK store DOM.
- **Diebels** image returned a placeholder — no real image found yet.
After updating the catalog: rebuild (`npm run build` in the worktree), commit, merge to main, push to both remotes, create GitHub release v0.1.6.
### 2. Test ghost emojis after D&D session
User will drink some beers and report back on how the greyed-out empty emoji slots look on the NSPanel Pro. Current implementation: `opacity: 0.15; filter: grayscale(1)`.
### 3. Test freshness warnings
Untested — will activate naturally as the keg approaches 14 days old.
### 4. Test tap dialogs on NSPanel Pro
Beer picker and glass size dialogs haven't been tested on the NSPanel Pro's touch screen yet.
## Architecture Notes
- **Worktree**: Implementation branch is at `.worktree/perfectdraft-card/` on branch `impl/perfectdraft-card`
- **Main branch**: Merged and pushed to both remotes after each release
- **Remotes**: `origin` = Gitea (git.falkvinge.net), `github` = GitHub (Falkvinge/hassio-component-perfectdraft-pro)
- **Credentials**: `.git/credentials` store file with PATs for both remotes
- **Build**: `npm run build` in worktree produces `dist/perfectdraft-card.js` + `dist/kegs/*.png`
- **HACS**: Downloads from GitHub release tags. `dist/` is committed (not gitignored).
- **Entity resolution**: Uses `hass.entities` registry with `platform === "perfectdraft"` and `translation_key` for sensor mapping. Entity IDs do NOT contain "perfectdraft" — they use user-chosen device names.
- **Editor version**: Shown in top-right of card editor. Keep in sync with GitHub release tags.
- **Image base URL**: Detected at runtime via `getCardBaseUrl()` scanning `<script>` tags for "perfectdraft-card".
## Sibling Project
The PerfectDraft Pro HA integration is at `/home/rick/Lab/Dev/Hassio-PerfectDraftPro`. The card reads its sensors via the HA entity registry. The integration's `DISCOVERY.md` has the full API documentation.
## OpenSpec
The change `perfectdraft-card` has all artifacts complete in `openspec/changes/perfectdraft-card/`. Tasks file tracks progress at 65/73 (remaining are manual testing tasks).
+70 -10
View File
@@ -4,18 +4,21 @@ A custom Lovelace card for the [PerfectDraft Pro Home Assistant integration](htt
Designed and optimised for the Sonoff NSPanel Pro 120 in landscape mode, but works on any HA dashboard.
![PerfectDraft Card showing Leffe Blonde at 3°C with 18 glasses remaining](docs/screenshot.png)
## Features
- **Beer emoji pictogram** — see how many glasses remain in your keg at a glance
- **Built-in beer catalog** — 45+ PerfectDraft beers with brand color palettes
- **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
- **Beer selector** — tap the label zone to pick your current beer from the catalog
- **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](https://github.com/Falkvinge/hassio-integration-perfectdraft-pro) installed and configured
- [PerfectDraft Pro integration](https://github.com/Falkvinge/hassio-integration-perfectdraft-pro) **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
@@ -35,23 +38,61 @@ Designed and optimised for the Sonoff NSPanel Pro 120 in landscape mode, but wor
3. Go to **Settings → Dashboards → Resources** and add `/local/perfectdraft-card/perfectdraft-card.js` as a JavaScript Module
4. 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:
1. Edit your dashboard → Add Card → search for "PerfectDraft Card"
2. The editor auto-discovers your PerfectDraft device(s)
3. Select your default beer and glass size
4. Done!
3. Pick your glass size and layout
4. 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)
```yaml
type: custom:perfectdraft-card
device_id: "perfectdraft_pro"
beer_name: "Leffe Blonde"
glass_size: 330
# beer_entity: sensor.perfectdraft_pro_keg_name # future: auto beer detection
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"
@@ -64,10 +105,24 @@ glass_size: 330
| Action | What happens |
|--------|-------------|
| Tap the **left zone** (beer label) | Opens beer selection dialog |
| Tap the **right zone** (emoji grid) | Opens glass size selection dialog |
Selections persist in your browser across page refreshes.
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
@@ -88,6 +143,11 @@ The card reads these sensors from the PerfectDraft integration:
| `*_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
BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 46 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 16 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 35 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 35 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 31 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 15 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 39 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 26 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 24 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 35 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 35 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 26 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 29 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 31 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 21 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 31 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 31 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 28 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 29 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 12 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 24 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 24 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 28 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 26 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 26 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 15 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 28 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 31 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 31 KiB

BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

Some files were not shown because too many files have changed in this diff Show More