// Configures Home Assistant dashboards and automations on ultraviolet. Use when editing HA dashboards, Bubble Cards, YAML configs, or using hass-cli.
| 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. |
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.
| 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 # List all entities
hass-cli state get <entity_id> # Get entity details
hass-cli service call <service> # Call a service
Token: ~/.config/home-assistant/token
All cards use custom:bubble-card. Common patterns:
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_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 %}
}
- 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
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
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 settingshome-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
Use when a Steam, Proton, Wine, Lutris, or Heroic game misbehaves on Linux — crashes at launch, black screen, missing DLSS / Ray Tracing / Path Tracing / DLSS-RR / Frame Generation, anti-cheat failures, shader stutter, controller or HDR or Wayland-fullscreen problems, intro-video failures ("Failed to create SourceReader", MF_E_UNEXPECTED), NVAPI "Unknown function ID" log spam, gamescope dedup black-screens, vkd3d swapchain crashes. Especially before patching or forking DXVK, vkd3d-proton, dxvk-nvapi, gamescope, Wine, or Proton; before reading RE Engine, Unreal, Unity, Source 2, id Tech, or Decima logs; or when a game is mentioned with NVIDIA Blackwell, NixOS, niri, gamescope, proton-cachyos, GE-Proton, or proton-tkg. Triggers on phrases like "won't launch", "RT/PT grayed out", "Proton fix for", "/WineDetectionEnabled", "ProtonDB", "VKD3D_CONFIG", "PROTON_USE_WAYLAND", or any moment the impulse is "let me read the Proton/Wine/vkd3d source" before checking community fixes.
Builds NixOS installer ISOs for hosts using the autoInstaller module. Use when creating installer USBs, adding new hosts to the installer system, or troubleshooting installer issues.
Patterns for this nix-config flake repository. Use when editing .nix files, adding packages, creating modules, or debugging flake issues.