Repository navigation
v2.0.0
Kegwall 2.0 redraws every screen in one design language: the TV wall (14 looks, each showing
what's left as a picture and in pints), the pour takeovers, the admin, the Wall Editor, the phone
menu and the kegerator kiosk. No feature is removed and no stored data is migrated.
Before you upgrade:
-
Every wall changes appearance: the looks are redrawn from their names. Stored wall settings are
kept as they are, so reinstalling 1.17 brings every wall back unchanged. -
Custom CSS that targets the pre-2.0 wall class names (
.tap-card,.ledger-lookand the other
per-look classes,.wall-header,.ticker,.qr-overlay) no longer matches. Use the
[data-look],[data-tap-state]and[data-surface]hooks; see
Customizing walls. -
Themes now change color only; every theme uses the Kegwall type (Big Shoulders Display and
Atkinson Hyperlegible). -
The admin Appearance setting is gone: the admin is dark, or light when the device prefers it.
-
Changed: the admin opens on Tonight instead of the dashboard: a sentence about the
night, what needs doing, the last pour, every tap as a glass with servings left, pours by hour,
screens, hardware, the next kegs to kick and the latest activity. -
Changed: the admin has a top bar instead of a sidebar: six destinations (Tonight, Taps &
kegs, Beers, People, Screens, Insights), Search, the notification bell, Settings and an account
menu. A destination's pages show as tabs under the bar; every existing admin address still
works. On phones the destinations open from Menu as a sheet. -
Changed: one admin design, dark by default and light when the device prefers it.
-
Changed: Taps & kegs is rebuilt. Taps is one table with what's left in servings, the
kick forecast and the bound monitor, filter chips (needs a swap, due for cleaning) and a drawer
per tap for cleaning, on deck and kicked history. Swapping a keg runs in a drawer that offers
the tap's next-up keg and another keg of the same beer first. Kegs shows costs as numbers over
one table with editing in a drawer; Suppliers lists each supplier's week at a glance beside its
price book; Monitors says whether each device is receiving and maps each port to its tap. -
Changed: Beers is a library of cards with each beer's marker and where it is (on tap
with its level, on deck, or in the library), with search and filters. The editor opens in a
drawer with a live preview of the beer's marker. -
Changed: Settings lists its sections down the side (Taproom, Kegtron and sources,
Integrations and alerts, System) with a line on what each holds; "Saved." appears as a short
confirmation in the corner. Automations reads each rule as one sentence ("When a keg drops
below 15%, notify in the app.") with an On, Off or Just ran state beside it and a switch to
turn it off. Diagnostics leads with the connection doctor's verdict, and Notifications says
how many are unread. -
Changed: Insights opens Analytics with a sentence about the range and KPIs set as
large numbers; the range switch and tabs sit under it. Every pour says how many of tonight's
pours have no name, and Logs counts the problems in the range. -
Changed: People names this month's leader, shows each pourer as a card with their pours
and volume, and lists accounts with what each role can do. Adding and editing someone happens
in a drawer that first asks whether it's an account or a pourer. -
Changed: pour takeovers are rebuilt. Full shows a glass filling from a stream of beer,
Split slides a panel in the beer's color, Dock lifts the wall for a filling bar, Fill floods
the screen, Spotlight lifts the pouring card, and Off keeps the wall still with a live
counter on the pouring row. Every style handles several taps pouring at once, one lane each. -
Changed: the Chalkboard, Editorial, Neon, Terminal, Poster, Departures and Zen looks are
redrawn from their names, each showing what's left as a picture and in pints: chalk tally
gates, a magazine contents page with level rules, neon rings, ASCII gauges with the pour
log, a festival line-up, a split-flap board sorted by kick time, and an orb. -
Changed: every part of a wall (rotation, leaderboard view, banners, game strip, pour
takeovers, screensaver) scales with the screen the same way, so a 4K TV no longer needs
the browser zoom workaround. -
Changed: the Classic, Ledger, Columns and Gallery wall looks are redrawn. Every card,
row, column or plate is the keg itself, filled in the beer's color, with what's left stated
in pints ("≈ 32 pints left") using the taproom's serving size. Classic picks its layout by
tap count (large cards, two rows of cards, or board rows). Existing walls on these looks
change appearance on upgrade. -
Changed: redrawn looks render on a fixed 1920 × 1080 layout scaled to the screen, so
720p, 1080p and 4K TVs show the same composition with no white band at 720p and no
overlapping names at 4K; text is never smaller than 22 px at 1080p. -
Changed: themes keep their colors, but secondary text and warning colors on redrawn
looks are adjusted to meet WCAG contrast in every theme. -
Changed: TVs, phones and kiosks download only their own screen's code and styles. A wall
now loads 88 KB of CSS instead of 230 KB, and 237 KB of JavaScript instead of 374 KB; the
admin's styles load only with the admin. -
Added: the redrawn phone menu: the newest keg leads in its own color, search, style
family chips (Light, Hoppy, Dark, Sour), one row per beer with the name on its own line, and a
beer sheet with the description, rating, kick forecast and that tap's unclaimed pours. -
Added: the redrawn kiosk: bigger avatars and tiles for wet hands, and armed / pouring /
done as one screen with a glass that fills by the measured volume. -
Added: sign-in and first-run setup in the admin look, with one progress bar across setup
and the welcome wizard. -
Added: the Wall Editor studio: a rail of eight sections with a dot on each changed
one, a live 16:9 stage of the wall's own taps (Wall / Live pour / Screensaver, Fit / 100%,
page picker), a 14-look gallery with pictures, theme swatches, per-section Undo, Discard
changes, and a prompt before leaving with unsaved changes. -
Added: Screens pages on the new template: Walls as cards (look, what it does, which
paired screens show it, live view), Displays (Pair a screen, look and takeover overrides by
name), Presence (zones, sleep timers, motion sources and webhook, each zone named by wall and
address) and Games. -
Added: Ctrl K / ⌘K opens Search from anywhere in the admin: type part of a page's
name, arrow to it and press Enter. Editors and viewers never see admin-only pages there. -
Added: three pour takeover styles: Tap Pull (a handle swings, the glass fills and
slides off), Keg Drain (the keg empties live, pints left count down) and Game On
(the pour moves the pourer up a running game). -
Added: a Cheers finish for single full-screen pours, with the pourer's passport
pour number. -
Added: opt-in wall moments: Just kicked, Just tapped and Pour milestones (the house's
every-100th pour and each pourer's own hundreds). -
Added: two new wall looks: Tap Handles (each tap a handle in its beer's color with a
sight glass; the pouring handle tips forward) and Tally (the night as a sentence, every
keg's pints left as tally marks). -
Added: prices on the Chalkboard look when pricing is turned on.
-
Added: the Just Tapped wall look, the default for new walls: the newest (or a
pinned) keg fills half the screen in its own color, with the tap list beside it. -
Added: tap markers (the beer's color, initials and tap number) on every redrawn look;
uploaded label art replaces the initials. -
Added: stable custom-CSS hooks:
[data-look],[data-surface="wall"],
[data-tap-state]and[data-testid="tap-marker"]. -
Added: every tap in the live wall feed now carries tonight's pours and volume (since
4 am), pours in the last hour and a projected kick date, and the wall and menu payloads
carry the taproom's serving size. None of it reveals keg cost. -
Added: current screenshots in the README and docs (every wall look, the pour takeovers,
Tonight, Taps & kegs, Beers), generated from the app bynpm run docs:images. -
Removed: the admin Appearance setting (Midnight Slate, Workshop, Console). A saved
choice is ignored. -
Fixed: the phone menu's claim sheet was see-through on the default theme; every sheet is
now opaque. -
Fixed: phone menu names squeezed into two-word lines beside the style and ABV columns.
-
Fixed: the kiosk didn't say when it couldn't get the taps ready for a pourer.
-
Fixed: a screen's look override accepted only 4 of the 14 looks and 6 of the 9 pour
styles; choosing any other was rejected. -
Fixed: unpairing a screen happened on one click; it now asks first. Pairing codes are no
longer shown to viewer accounts on the Displays page. -
Fixed: starting or ending a game failed silently; the error is now shown.
-
Fixed: walls with the same name couldn't be told apart on the Presence page.
-
Fixed: Analytics showed an average pour quality of 0 when no pour had a quality
score; it now shows — and says there's no Kegtron quality data yet. -
Fixed: Needs attention listed one row per tap for the same problem (eleven "Tap N is
due for a line cleaning" rows buried a source that was down). Each kind is now one row with one
action, ranked problem, then caution, then information. -
Fixed: the end of a pour showed the last live reading instead of the recorded volume,
which could be several ounces short when the last Kegtron packet lagged the final pour. -
Fixed: the Dock and Fill takeovers had no finish; Split's light panel broke dark themes.
For contributors:
- Added:
tests/e2e/touch.spec.tsfails when any control on the phone menu, the beer sheet
or the kiosk is smaller than 44 × 44 px. - Added:
npm run lint:csslists stylesheet rules for classes nothing renders (--fix
deletes them); a test runs the same check, so CI fails on a dead selector. - Fixed: the system stats test read the host's real
/var/run/reboot-requiredand failed on
any machine waiting for a reboot. - Added:
npm run visual:contrastrenders every redrawn look in every theme and fails on
any text below WCAG AA contrast. - Added: a visual harness (
npm run visual:capture,npm run visual:diff) that seeds a
synthetic taproom, photographs every surface at TV, desktop, tablet and phone sizes, and
pixel-diffs two runs. Plusscripts/visual/wpe-probe.htmlto check a display's browser engine.