Core Concepts
LCARdS cards are driven by a set of shared singleton services, and a set of per-card configuration options shared across all card types. This section covers both.
Per-Card Options
Options you configure directly in individual card YAML:
| Option | Description |
|---|---|
| Actions | Tap, hold, and double-tap actions wired to any HA service call |
| Colours | Accepted colour formats and state-based colour maps |
| Presets | Named style collections — apply a full card appearance in one line |
| Sounds | Event-driven audio feedback via the Sound Manager |
| Styles | The style: block — card background, border, icon, and dimension overrides |
| Text Fields | Label and value field templating reference |
Core Services
Shared singleton systems that all cards tap into:
| Service | Description |
|---|---|
| Alert Mode | Coordinated dashboard-wide red/yellow alert states with full UI and audio transformation |
| Data Sources | Live entity subscriptions, polling, history buffers, and transformations |
| Rules Engine | Conditional styling engine — change colours, icons, labels, and trigger animations based on entity state |
| Templates | Four template types — JavaScript, token, data source, and Jinja2 — evaluated uniformly across all properties |
| Themes | Token-based colour palette shared across all cards |
Effects
| Effect | Description |
|---|---|
| Animations | anime.js-powered animations triggered by interactions or entity changes |
| Background Animations | Canvas2D animated backgrounds behind card content |
| Filters | Stackable CSS and SVG visual filters — blur, brightness, colour shift, displacement |