Core Concepts
LCARdS cards are driven by a set of shared singleton services. Understanding these systems lets you build reactive, animated, and context-aware dashboards far beyond what static YAML can produce.
| Concept | Description |
|---|---|
| Alert Mode | Coordinated dashboard-wide red/yellow alert states with full UI and audio transformation |
| Presets | Named style collections — apply a full card appearance in one line |
| Styles | The style: block — card background, border, icon, and dimension overrides |
| Colours | Accepted colour formats and state-based colour maps |
| Text Fields | Label and value field templating reference |
| Actions | Tap, hold, and double-tap actions wired to any HA service call |
| Sounds | Event-driven audio feedback via the Sound Manager |
Systems
| System | Description |
|---|---|
| Templates | Four template types — JavaScript, token, DataSource, and Jinja2 — evaluated uniformly across all properties |
| 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 |
| Themes | Token-based colour palette shared across all cards |
| Animations | anime.js-powered animations triggered by interactions or entity changes |
| Filters | Stackable CSS and SVG visual filters — blur, brightness, colour shift, displacement |
| Background Animations | Canvas2D animated backgrounds behind card content |