luma-home/ha-cards/HANDOFF.md

Luma HA Cards — Deployment Handoff

What this is

Custom Lovelace card bundle that replicates the Luma TV launcher's glass UI as a Home Assistant dashboard. Built in a single session on 2026-10-27.

Files in ha-cards/

File	Size	What it does
luma-cards.js	43 KB	Main card element (<luma-card>) — glass cards with accent glow per domain, brightness bars, curtain SVGs, media artwork. Click opens a slide-in panel (420px, right edge) with full controls for each domain.
luma-weather-card.js	7 KB	Weather card (<luma-weather-card>) — current conditions + 5-day forecast row.
luma-theme.yaml	2.5 KB	HA theme (luma_glass) — dark glass palette, gold accent, Inter font.
dashboard.yaml	7 KB	Full dashboard YAML — all 8 rooms from ha-home/config.json, native HA grid cards, no HACS dependencies.
README.md	3 KB	Installation steps (also summarised below).

Slide-in panel controls per domain

Domain	Panel sections
light	Brightness slider + presets (Off/25/50/100%) + colour temp + colour swatches + effects grid
climate	Target temp + HVAC mode icons + fan auto (Auto/Quiet/Turbo) + fan manual slider + airflow buttons
cover	Position slider + Open/Stop/Close + presets (Open/60/45/30/Closed)
media_player	Now playing (art + title + artist) + progress bar + transport (prev/play-pause/next) + volume
vacuum	Status + battery + fan mode buttons + Start/Pause/Dock
switch/scene/script	No panel — click toggles directly

Design token mapping

All colours, radii, shadows, and sizes come from design-system/tokens.json. Key values hardcoded in the JS T object:

• Card fill: rgba(34,38,46,0.88), border rgba(255,255,255,0.10), radius 22
• Panel fill: rgba(30,34,42,0.98), width 420, radius 28
• Accents: light #F5B85A, heat #F06A4A, cool #4C9BF0, curtain #DCD2B4, media #9B7DDB, vacuum #60C090

Deployment steps (on Unraid SSH → HA)

1. Copy JS + theme files to HA

From Unraid (which has the repo or can pull from Gitea):

# Clone or pull on Unraid
cd /tmp && git clone https://jazzymc:<password>@git.xtrm-lab.org/jazzymc/luma-home.git 2>/dev/null || (cd /tmp/luma-home && git pull)

# SCP to HA (needs HA SSH addon password or key)
scp -P 22 /tmp/luma-home/ha-cards/luma-cards.js /tmp/luma-home/ha-cards/luma-weather-card.js root@192.168.10.102:/config/www/luma/

# Or if the HA Terminal addon is used, from inside HA:
mkdir -p /config/www/luma
# then pull files via scp from Unraid

2. Register Lovelace resources

In HA → Settings → Dashboards → Resources (top-right ⋮ menu), add:

URL	Type
/local/luma/luma-cards.js	JavaScript Module
/local/luma/luma-weather-card.js	JavaScript Module

Or in configuration.yaml:

lovelace:
  resources:
    - url: /local/luma/luma-cards.js
      type: module
    - url: /local/luma/luma-weather-card.js
      type: module

3. Install theme

Copy theme file:

mkdir -p /config/themes
cp /tmp/luma-home/ha-cards/luma-theme.yaml /config/themes/luma_glass.yaml

Or merge into existing themes config. Then reload themes in Developer Tools → YAML → Themes.

4. Create dashboard

Settings → Dashboards → Add Dashboard → set title "Luma Home", icon mdi:television. Switch to YAML mode and paste dashboard.yaml contents.

Or add to configuration.yaml:

lovelace:
  dashboards:
    luma:
      mode: yaml
      title: Luma Home
      icon: mdi:television
      show_in_sidebar: true
      filename: dashboards/luma.yaml

Then cp ha-cards/dashboard.yaml /config/dashboards/luma.yaml.

5. Activate theme

Profile (avatar) → Theme → Luma Glass.

What's NOT deployed yet (TV binary)

The Luma TV binary with all 11 fixes from this session was compiled and is at /mnt/user/appdata/luma-build/target/armv7-unknown-linux-gnueabi/release/luma on Unraid and /tmp/luma-deploy on Mac. The TV (192.168.30.124) was offline during this session. Deploy when it comes back online — see the main project README for the deploy process.