🌦️ Nimbus Weather Card

A beautiful, Apple Weather‑inspired custom card for Home Assistant with smooth particle effects, dynamic backgrounds, and full moon phase support.

🔗 GitHub: https://github.com/maxfok/nimbus-weather-card
📦 HACS: Install as a custom repository while default HACS inclusion is pending

---

✨ Features

• Stunning visuals – gradient backgrounds, floating particles (rain, snow, fog, clouds, wind, lightning)
• Dynamic day/night – automatically switches between sun/moon, starry sky, and colour‑shifting gradients
• Moon phases – renders realistic waxing/waning moons with NASA texture and all 8 phases
• Shooting stars – on clear nights, a random star detaches and streaks across the sky, then fades back in
• Feels‑like temperature – shows apparent temperature when available
• Smart units – automatically converts °C/°F reading native entity attributes
• Multilingual – English, Spanish, German, Dutch (and more via PR!)
• Hourly/Daily forecast toggle – tap the forecast bar to switch view
• Custom tap action – navigate, call-service, url, or more-info
• Clock & date panel – optional, togglable
• HACS compatible – one-click install via custom repository

---

🆕 What's new in v2.3.0

This release focuses on atmosphere, smoother transitions, and a more polished forecast modal experience.

🌅 Slow Background Cross-Fade

Sky gradients now transition with a slow 3-minute cross-fade instead of an abrupt change. Sunrise, golden hour, daytime, and night phases blend naturally as sun elevation changes. The card also schedules a refresh around key sun-elevation thresholds so the sky updates at the right moment.

🌌 Aurora Borealis

Clear nights in the Arctic latitude zone can show a soft aurora overlay with layered green, blue, and purple ribbons. Enabled via latitude_zone: arctic in your card config.

type: custom:nimbus-weather-card
entity: weather.home
latitude_zone: arctic

⚡ Lightning Flash Effect

Thunderstorm conditions now include a sky-flash overlay that briefly illuminates clouds, rain, and droplets. Bolt and flash fading is slower and the secondary flash delay is longer, so strikes feel more natural.

📊 Forecast Modal Polish

• Haptic feedback on open/close
• Tap backdrop to close
• Swipe down from handle to close
• Escape key support on desktop
• Improved accessibility (role="dialog", aria-modal, aria-hidden)
• Larger modal handle
• Better mobile gesture handling (no background scroll bleed)

🌠 Shooting Stars

On clear nights, a random star detaches and streaks diagonally across the sky every 4–14 seconds, then fades back into place.

🔧 Small Improvements

• Refined night gradient colour
• Improved layer ordering for backgrounds, aurora, effects, lightning, droplets, and content
• Moon remains visible when condition is explicitly clear-night
• Internal timer cleanup when card is removed or rebuilt
• Removed leftover debug logs

---

📋 Changelog

v2.3.0

• ✨ Slow background cross-fade — sky gradients blend over ~3 minutes between elevation zones
• ✨ Aurora Borealis — soft aurora overlay for latitude_zone: arctic on clear nights
• ✨ Lightning flash effect — sky illumination during thunderstorms, slower/more natural timing
• ✨ Forecast modal polish — haptic feedback, swipe-to-close, backdrop tap, Escape key, accessibility improvements
• ✨ Shooting stars — existing stars detach, streak, and fade back in on clear nights
• 🐛 Moon remains visible when condition is explicitly clear-night
• 🔧 Internal timer cleanup, improved layer ordering, removed debug logs

v2.2.0

🌅 Sky & Sun

• New multi-phase sky gradient system with smooth colour interpolation
• 7 elevation zones: deep night → nautical dawn → blue hour → sunrise/sunset → golden hour → morning → daytime → midday
• Extended sun elevation range to −30°..90°

🌙 Moon

• Moon auto-detected from sensor.moon_phase (no config needed)
• Moon fixed to top-right corner — no longer goes offscreen on short cards
• More precise phase calculation using UTC time

📊 Forecast Modal

• Tap the forecast bar to swap between daily ↔ hourly view
• tap_action support: More Info, Navigate, Open URL, None

📱 Mobile

• Dedicated mobile cloud rendering for sharper display on touch devices
• Better cloud detection for rainy, pouring, snowy-rainy conditions

🌡️ Thermometer

• Redesigned icon matching the style of humidity, wind and pressure icons

🐛 Bug Fixes

• High/Low always shows daily values even when hourly forecast is selected
• clear-night condition now correctly shows sun icon during daytime (fixes KNMI / NL Weather integration)

v2.0.1

• ✨ Multilingual support — English, Spanish, German (thanks u/R3x10 & u/super-gando!)
• ✨ Language selector in card editor
• 🐛 Fix: HACS update notifications now work correctly (missing filename in hacs.json)
• 🐛 Fix: Forecast icons correctly show day/night per hour (no more moon at 1pm!)
• 🐛 Fix: Sun entity takes priority over weather state for day/night detection

v2.0.0 — Complete rewrite 🎉

• ✨ Animated rain with wind skew (based on wind_bearing)
• ✨ Glass window droplets for rainy conditions
• ✨ SVG cloud layers with per-condition opacity
• ✨ Snow animation with 3-layer canvas and sine-wave sway
• ✨ Lightning with midpoint-displacement branching bolt algorithm
• ✨ Autumn leaf gusts for windy conditions
• ✨ Dynamic solar gradient based on sun.sun elevation
• ✨ NASA moon texture with full 8-phase rendering
• ✨ Moon hemisphere rotation based on latitude

---

🔧 Installation

Via HACS custom repository

1. Open HACS → Frontend
2. Click the three-dot menu (⋮) → Custom repositories
3. Add URL: https://github.com/maxfok/nimbus-weather-card
4. Category: Dashboard
5. Click Add, then find Nimbus Weather Card and install

Manual

1. Download nimbus-weather-card.js
2. Copy to /config/www/nimbus-weather-card.js
3. Add as a custom resource: Settings → Dashboards → Resources → Add
   • URL: /local/nimbus-weather-card.js
   • Type: JavaScript module

---

⚙️ Configuration

type: custom:nimbus-weather-card
entity: weather.forecast_home
sun_entity: sun.sun          # optional but recommended
moon_entity: sensor.moon     # optional, for moon phases
language: en                 # en | es | de | nl
show_clock: true             # optional clock/date panel
tap_action:
  action: navigate
  navigation_path: /lovelace/weather

All options

Option	Default	Description
entity	required	Your weather entity
sun_entity	sun.sun	For accurate day/night detection
moon_entity	—	Moon phase sensor
language	en	en, es, de, nl
show_clock	false	Show clock & date panel
show_details	true	Show humidity, wind, pressure
tap_action	more-info	Standard HA tap action
ufo_easter_egg	false	🛸 You'll know when you see it
latitude_zone	—	arctic for aurora borealis on clear nights

---

🌍 Add your language

Translations are just a few lines of JSON. Open a Pull Request!
See existing translations in the source for the format.

---

🐛 Bugs & Feature Requests

Open an issue on GitHub or comment on the HA Community thread.

---

❤️ Support

If you like Nimbus, consider giving it a ⭐ on GitHub!