0.59.0 - Frosted Glass Theme Support + Ambient Light backgrounds + Entity State Display + High Contrast Mode + Hide Entities!! 🏂 ⛄

Happy Holidays and all that... 🎄❄️

Thanks to everyone who uses this card! ⭐ We're close to 200 stars and have closed almost as many issues and features. Hope you all have a great end-of-year break—my wife and I will be chilling with the cats here in Florida.

I want to show my appreciation for everyone who has submitted features. This card started as a simple replacement for a large button-card template, but thanks to your suggestions, it now has tons of customizations and cool features.

Shameless plug: thanks to anyone who's bought me a coffee! ☕ My wife gets excited showing me the Ko-fi emails. You don't have to, but the caffeine is put to good use.

Now for the last release of 2025 maybe?!

New Feature: Entity State Display

Added support for displaying entity state values directly below entity labels using the show_state feature flag. This allows you to see the current state (e.g., brightness percentage, temperature, etc.) for each entity without needing to open the entity details.

Example Configuration:

type: custom:room-summary-card
area: living_room
features:
  - show_entity_labels
entities:
  - entity_id: light.living_room
    features:
      - show_state
  - entity_id: fan.ceiling_fan
    features:
      - show_state

Custom Styling:

You can customize the appearance of the state display using CSS variables:

entities:
  - entity_id: light.living_room
    features:
      - show_state
    styles:
      '--user-entity-state-font-size': 0.8em
      '--user-entity-state-color': '#ff6b6b'
      '--user-entity-state-opacity': 0.9
      '--user-entity-state-font-weight': bold

New Feature: Ambient Lights

Added support for ambient lights - lights that only affect the card background, not the icon/title. Perfect for RGB LED strips or accent lighting!

lights:
  - light.ceiling # Regular - affects icon AND background
  - entity_id: light.led_strip
    type: ambient # Ambient - affects background ONLY

This allows your LED strip to color the background the color of the strip while your ceiling light colors the icon yellow.

New Feature: Frosted Glass Theme Support

Added automatic detection and styling for Frosted Glass themes. The card now automatically detects when a Frosted Glass theme is active and applies transparent blurred card effects with backdrop filters for seamless integration.

This might be a fun theme just for the day :)

Examples:

• Light mode:
• Dark mode:

Thanks to @devkaiwang for the idea!

New Feature: Icon Opacity Preset

Added a new Icon Opacity Preset option in the editor that allows you to easily adjust icon visibility. The "High Visibility" preset sets icon opacity to full visibility (opacity: 1) with reduced fill opacity (0.2) for both active and inactive states, making icons easier to see.

Configuration:

The preset can be set via the editor dropdown in the Styles section, or directly in YAML:

type: custom:room-summary-card
area: living_room
icon_opacity_preset: high_visibility

Available options:

• default - Uses the standard theme opacity values
• high_visibility - Sets icons to full opacity with reduced fill opacity for better visibility

New Feature: Hide Hidden Entities

Added a new hide_hidden_entities feature flag that allows you to automatically skip entities that are marked as hidden in Home Assistant's entity registry. This keeps your card display clean by excluding entities you've hidden in Home Assistant, even if they're in the configured area or entity list.

Example Configuration:

type: custom:room-summary-card
area: living_room
features:
  - hide_hidden_entitie
entities:
  - light.living_room_main
  - switch.living_room_fan
  - sensor.living_room_temperature

How It Works:

When enabled, the card will automatically filter out any entities that have the hidden: true flag set in Home Assistant's entity registry. This applies to:

• Icon entities (lights, fans, switches, etc.)
• Sensor entities (temperature, humidity, etc.)
• Configured sensors
• Threshold sensors
• Light entities (for multi-light background feature)

This is particularly useful when you have entities hidden in Home Assistant that you don't want to appear in the card, keeping your dashboard focused on the entities you actually want to see and control.

---

• chore: bumps version to 0.59.0 by @gh-action-bump-version
• correct sensor documentation by @warmfire540
• fix test by @warmfire540
• hide hidden entities - thanks @viprapp! by @warmfire540
• chore: yarn (deps-dev): bump sinon in the all-dependencies group (#324) by @dependabot[bot]
• high contrast mode - thanks @ojm88! by @warmfire540
• code smells by @warmfire540
• display entity state - thanks @Ltek! by @warmfire540
• ambient light config - thanks @fonix232! by @warmfire540
• chore: yarn (deps-dev): bump jsdom in the all-dependencies group (#318) by @dependabot[bot]
• support frosted glass theme - thanks @devkaiwang! by @warmfire540

What's Changed

• chore: yarn (deps-dev): bump jsdom from 27.2.0 to 27.3.0 in the all-dependencies group by @dependabot[bot] in #318
• chore: yarn (deps-dev): bump sinon from 21.0.0 to 21.0.1 in the all-dependencies group by @dependabot[bot] in #324
• Frosted Glass Theme Support + Ambient Light backgrounds + Entity State Display + High Contrast Mode + Hide Entities!! 🏂 ⛄ by @warmfire540 in #317

Full Changelog: 0.58.0...0.59.0