Releases: aspenrt78/button-builder
Releases · aspenrt78/button-builder
v2.2.10
v2.2.9
v2.2.8 - Self-hosted brand icons
Changed\n- Brand icons now self-hosted: Added �rand/ directory inside the integration with icon.png, logo.png, dark_icon.png, and dark_logo.png. Starting with Home Assistant 2026.3.0, custom integrations can ship their own brand images directly — no separate brands repository PR required.
v2.2.7 - Fix Card Background Color Picker
Fixed\n- Card Background Color Picker: Background color and default text color in Colors & Theming now correctly update the base card style. Previously, picking a background color after disabling Auto Color had no visible effect because the change was stored as a state-conditional override instead of the base card background.
v2.2.6 - Smart Option Visibility
What's New
Comprehensive option visibility audit
Options that don't apply to the current configuration are now hidden, keeping the editor clean and contextual.
Entity > Core:
- State Display (Custom) hidden unless Show State is on
- Entity Picture URL hidden unless Show Entity Picture is on
- Units Override hidden unless Show State or Show Units is on
Appearance > Colors:
- Icon Color hidden unless Show Icon is on
- Name Color hidden unless Show Name is on
- State Color hidden unless Show State is on
- Label Color hidden unless Show Label is on
- Hint shown when all element visibility is off
Appearance > Borders:
- Border Color hidden when Border Style is 'none'
Appearance > Glass & Depth:
- Shadow Color and Shadow Opacity hidden when Shadow Size is 'none'
Appearance > Animations:
- Speed, Trigger, and Always Animate options hidden when animation type is 'none' (both card and icon)
Appearance > Typography:
- Numeric Precision hidden unless Show State is on
Appearance > Conditionals:
- Override: Name field only shown when Show Name is on
- Override: Label/State Text row only shown when Show Label or Show State is on
- Colors: Icon color only shown when Show Icon is on
- Colors: Name/State/Label colors only shown when respective visibility is on
Style > Threshold Alerts:
- Apply To checkboxes now gated: Icon/Name/State/Label only shown when respective element is visible
Actions > Card Actions:
- Hold Repeat and Repeat Limit hidden when Hold Action is 'none'
- Action Sounds section hidden when all three actions are 'none'; individual sounds only shown for active actions
v2.2.5 - Simplified Conditionals
What's New
Conditional styles moved to a dedicated section
- Conditionals now live under Style → Conditionals in the editor panel instead of being buried at the bottom of Colors & Theming
- Each condition collapses to a one-line summary (e.g. light.my_lamp equals on) and expands on click — much easier to manage multiple conditions
- All fields reorganized into compact grouped rows: When / Override / Colors / Animation
Entity auto-fill fix
- Changing the entity now always updates the name and icon to match the new entity, instead of only updating when the previous values were the original defaults
v2.2.4 - OFF State Dimming
What's New
Buttons now visually indicate OFF state by default
Previously, a button with a custom background color looked identical whether the entity was ON or OFF, because \styles.card\ applies to all states in button-card.
Now, for binary entities (lights, switches, fans, automations, etc.):
- ON: button displays at full brightness with your chosen color/gradient
- OFF: button is automatically dimmed to 50% brightness (\ ilter: brightness(0.5))
This happens automatically — no configuration needed. The preview now matches this behavior too.
The dimming is skipped when:
- You've set an explicit OFF-state background color (State Off Color)
- You've added a conditional style matching \off\
- \color: auto\ is enabled (button-card's own entity-color behavior handles on/off visually)
- The entity is not binary (sensors, media players with non on/off states, etc.)
v2.2.3 - YAML/Preview Parity Fixes
Bug Fixes
- show_name / show_icon: Setting these to false now correctly emits \show_name: false\ / \show_icon: false\ in YAML. Previously the flags were silently dropped and HA would show the element regardless.
- perform-action: The \perform-action\ action type now correctly outputs \perform_action:\ and \data:\ keys (new HA format) including service, data, and target. Import also updated.
- Background color opacity in conditionals: Conditional state styles with partial background opacity now correctly wrap the color in
gba()\ instead of emitting raw hex. - aspect-ratio double-emit removed: Aspect ratio was being emitted both as a top-level property and inside \styles.card, causing conflicts. Now only emitted at top-level.
- color:auto conflict fixed: When \color: auto\ was enabled, a \color:\ value was still written into \styles.card\ overriding the auto behavior. Now omitted when auto color is active.
- Icon Spin preview fixed: The \spin\ property (Icon Spin checkbox) now animates in the preview card, matching the generated YAML output.
- Button name YAML-safe: Button names containing colons or other YAML-special characters are now properly double-quoted in output.