Shabbat Card
March 21, 2026 · View on GitHub
Animated Shabbat/Yom Tov status card for Home Assistant with sun-driven sky gradients, a melting candle, progress tracking, and countdown timer.
Prerequisites
- Home Assistant with the Jewish Calendar integration installed
Installation
HACS (Custom Repository)
- Open HACS in your Home Assistant
- Click the three dots menu → Custom repositories
- Add this repository URL with category Lovelace
- Search for "Shabbat Card" and install
- Clear your browser cache
Manual
- Download
shabbat-card.jsfrom the latest release - Copy to your
www/directory - Add the resource in Settings → Dashboards → Resources:
- URL:
/local/shabbat-card.js - Type: JavaScript Module
- URL:
Configuration
Minimal
type: custom:shabbat-card
Options
| Option | Type | Default | Description |
|---|---|---|---|
size | string | large | Card size preset |
preview | string | off | Preview mode for testing |
Size Presets
| Size | Description |
|---|---|
tiny | Single-line badge, no icon |
compact | Two-column with icon + countdown |
small | Two-column with progress ring |
medium | Full layout with times and date |
large | Full size with all details |
Preview Modes
| Mode | Description |
|---|---|
off | Live data from sensors |
shabbat_early | Shabbat just started (sunset) |
shabbat_mid | Middle of Shabbat (night) |
shabbat_late | Late Shabbat (near havdalah) |
motzei | Motzei Shabbat |
yom_tov | Yom Tov (Pesach) |
Features
- Sun-driven sky gradients that match the real sky
- Animated SVG melting candle with wax drips
- Progress ring showing Shabbat/Yom Tov completion
- Countdown to candle lighting or havdalah
- Twinkling stars at night
- Hebrew status text (שבת שלום, חג שמח, שבוע טוב)
- Multi-day Yom Tov support
- Zero-config — auto-discovers Jewish Calendar entities
- Visual config editor in the dashboard UI
License
MIT