nodalia-cards

A cohesive, app-like card system for modern Home Assistant dashboards.

Installation · Cards · Quick start · Support · Translate

---

Nodalia Cards is a custom Home Assistant frontend card suite built as one visual system rather than a collection of unrelated components. Shared design tokens, motion, interactions and editors give Home Assistant a polished, consistent experience across mobile, tablet and desktop.

Important

Inclusion in the default HACS catalogue is currently in progress. Until it is approved, install Nodalia Cards through HACS as a custom Dashboard repository using the steps below.

Preview

Why Nodalia

Design	Experience	Integration
Shared visual language	Mobile-first layouts	Native Home Assistant selectors
Consistent spacing and surfaces	Smooth, purposeful motion	Integrated visual editors
Theme-aware colours	Tactile controls and haptics	Minimal generated YAML
Cohesive popup system	Responsive cards and dialogs	Context-aware entities and services

The suite is designed for real daily dashboards: one interaction model, predictable configuration and a consistent finish across every card.

Included cards

Everyday controls	Insight and context	Spaces and navigation
Light	Circular Gauge	Navigation Bar
Fan	Graph	Room Summary
Humidifier	Power Flow	Person
Cover	Weather	Scenes
Climate	Calendar	Favourites
Alarm Panel	Notifications	Insignia
Media Player	News	Entity
Vacuum	Camera	Advanced Vacuum

Every card is registered with the custom:nodalia-… prefix. The complete set currently includes:

Show all custom element names

• custom:nodalia-navigation-bar
• custom:nodalia-media-player
• custom:nodalia-light-card
• custom:nodalia-fan-card
• custom:nodalia-humidifier-card
• custom:nodalia-circular-gauge-card
• custom:nodalia-graph-card
• custom:nodalia-power-flow-card
• custom:nodalia-cover-card
• custom:nodalia-climate-card
• custom:nodalia-alarm-panel-card
• custom:nodalia-advance-vacuum-card
• custom:nodalia-entity-card
• custom:nodalia-fav-card
• custom:nodalia-insignia-card
• custom:nodalia-person-card
• custom:nodalia-scenes-card
• custom:nodalia-weather-card
• custom:nodalia-calendar-card
• custom:nodalia-notifications-card
• custom:nodalia-vacuum-card
• custom:nodalia-news-card
• custom:nodalia-camera-card
• custom:nodalia-room-summary-card

Visual editors

All Nodalia cards include a visual editor designed to fit naturally into Home Assistant:

• native entity selectors and colour pickers
• compact, collapsible configuration sections
• shared translations and editor behaviour
• responsive previews
• automatic removal of default values

Only settings that differ from the defaults are written to YAML, keeping dashboard configuration readable and portable.

Installation

HACS custom Dashboard — recommended

Until the default HACS listing is approved:

1. Open HACS.
2. Open the three-dot menu and choose Custom repositories.
3. Add https://github.com/danielmigueltejedor/nodalia-cards.
4. Select category Dashboard.
5. Open Nodalia Cards and choose Download.
6. Restart Home Assistant.
7. Reload your browser (or perform a hard refresh).

If a card does not appear immediately after installation or an update, perform a hard refresh or clear the Home Assistant frontend cache.

/nodalia/nodalia-cards.js

That single file includes both the cards and their visual editors. It also enables native background notifications, shared dismissals and climate schedules without packages, helpers or user-created automations.

If a card does not appear immediately after an update, perform a hard refresh or clear the Home Assistant frontend cache.

Manual installation

1. Copy dist/nodalia-cards.js to your /config/www/ directory.
2. Add it as a Lovelace resource:

URL: /local/nodalia-cards.js
Type: module

1. Reload your browser.

Quick start

Add a card through the dashboard visual editor, or start with one of these minimal examples.

Light

type: custom:nodalia-light-card
entity: light.living_room

Calendar

type: custom:nodalia-calendar-card
calendars:
  - entity: calendar.home

Advanced vacuum

type: custom:nodalia-advance-vacuum-card
entity: vacuum.roborock
map_source:
  image: image.roborock_map
calibration_source:
  camera: true

Advanced guides

Feature	Documentation
Climate setpoint scheduling	Native weekly schedules
Advanced Vacuum compatibility	Platforms, live room tracking and fallbacks
News Card	Layouts, sources and configuration
Shared styling	Theme variables and card-mod reference
Background mobile notifications	Native delivery and legacy fallback
Translations	Contributor guide

Release channels

Maturity	Branch / tag	Intended use
Stable	main, vX.Y.Z	Recommended for daily dashboards
Release candidate	vX.Y.Z-rc.N	Final compatibility and release validation
Beta	beta, vX.Y.Z-beta.N	Feature-complete preview for broader testing
Alpha	alpha, vX.Y.Z-alpha.N	Active development; breaking changes are possible

HACS installs the latest stable release by default. To test a prerelease, open Nodalia Cards in HACS, choose Redownload → Need a different version?, and select the desired alpha, beta or RC tag.

Stable changes are documented in the changelog. Detailed prerelease notes live in CHANGELOG-PRERELEASES.md, and longer-term work is tracked in the roadmap.

Translations

Nodalia Cards currently includes Spanish, English, German, French, Italian, Dutch, Norwegian, Portuguese, Russian, Greek, Chinese and Romanian.

Help review or extend the project on Crowdin. Translation pull requests are also welcome; follow the translation guide to keep runtime and editor strings synchronized.

Support and contributions

• Use GitHub Issues for reproducible bugs and focused feature requests.
• Include the Home Assistant version, Nodalia Cards version, browser, relevant YAML and screenshots when reporting a visual problem.
• Read CONTRIBUTING.md before submitting code or translations.
• Never publish tokens, webhook secrets or private entity data.

Thanks to every tester, translator and contributor helping make the suite more useful, especially @Sppedtech, @flippedcracker, @loicloiseau, @pqpxo, @jjanssen95, @alfonsoluna, @Scraft08YT and @ryatesKT.

License

Nodalia Cards is released under the MIT License.

_{Designed and maintained by Daniel Miguel Tejedor.}