| name | configuring-home-assistant |
| description | Configures Home Assistant dashboards and automations on ultraviolet. Use when editing HA dashboards, Bubble Cards, YAML configs, or using hass-cli. |
Home Assistant Configuration
Dashboard Workflow
Dashboards use YAML mode (not UI storage). Edit YAML files directly, then run update to deploy. UI-based editing will NOT work - changes would be overwritten on rebuild.
Common Mistakes
| Wrong | Right |
|---|
| Editing dashboards in HA UI | Edit YAML files, run update |
Using standard light card | Use custom:bubble-card with button_type: slider |
| Duplicating styles inline | Use YAML anchors from cards/templates.yaml |
hass-cli state list
hass-cli state get <entity_id>
hass-cli service call <service>
Token: ~/.config/home-assistant/token
Bubble Cards Patterns
All cards use custom:bubble-card. Common patterns:
Light Slider Button
type: custom:bubble-card
card_type: button
button_type: slider
entity: light.room_name
name: Room Name
icon: mdi:lamp
show_state: true
show_attribute: true
attribute: brightness
slider_live_update: true
allow_light_slider_to_0: false
card_layout: large
Sub-Buttons with Conditional Styling
sub_button:
- entity: binary_sensor.door
show_background: true
styles: |-
.bubble-sub-button {
{% if is_state('binary_sensor.door', 'on') %}
background-color: rgba(239, 83, 80, 0.3) !important;
{% else %}
background-color: rgba(76, 175, 80, 0.3) !important;
{% endif %}
}
Popup Navigation
- icon: mdi:dots-horizontal
show_background: true
tap_action:
action: fire-dom-event
browser_mod:
service: browser_mod.popup
data:
title: Room Name
content: !include ../../popup-content/room.yaml
Popup Base Settings
card_type: pop-up
back_open: false
close_by_clicking_outside: true
bg_opacity: '88'
bg_blur: '14'
width_desktop: 540px
auto_close: 60000
show_header: true
YAML Anchors
Use anchors in cards/templates.yaml for reusable patterns:
&door_sensor_styles - Red/green conditional door status&water_sensor_styles - Leak sensor with pulse animation&light_slider_options - Standard light slider config&popup_base - Common popup settings
Directory Structure
home-assistant/dashboards/
├── ui-lovelace.yaml # Main dashboard
├── views/ # Dashboard views
│ ├── overview-cards/ # Room cards
│ └── sections/ # Section cards
├── popups/ # Popup definitions
├── popup-content/ # Popup card content
└── cards/templates.yaml # YAML anchors
