v1.4.0

What's new in v1.4.0

Added

• Rename the mode buttons - a new mode_names option (map of hvac_mode: "Label", e.g. mode_names: { fan_only: Fan, cool: Cooling }) relabels the OFF / COOL / DRY / etc. buttons. Any mode left unset keeps its default label. The visual editor gains a "Mode labels" section.
• Rename extra toggles in the editor - each extra_toggles chip now has its own name field in the visual editor, so a custom chip label no longer requires editing YAML.

No breaking changes.

Updating: update the card in HACS, then hard-refresh your browser (Ctrl+F5 / Cmd+Shift+R).

Full Changelog: v1.3.1...v1.4.0

v1.3.1

What's new in v1.3.1

Fixed

• extra_toggles select chips now work when the select has options but no option chosen yet (state unknown, common on Tuya "smart wind" / mode selects). The chip previously rendered dimmed and could not be tapped. It now stays a live cycle chip, a tap picks the first option, and it shows its name until an option is chosen. A genuinely unavailable entity still renders disabled.

No breaking changes.

Updating: update the card in HACS, then hard-refresh your browser (Ctrl+F5 / Cmd+Shift+R).

Full Changelog: v1.3.0...v1.3.1

v1.3.0

What's new in v1.3.0

New

• Custom toggle chips - the new extra_toggles option adds your own switch, input_boolean, select, or input_select entities to the mode popup as chips, for device functions the card does not auto-detect (anti-mildew, UV, a gentle-wind mode, and so on). Switches toggle, selects cycle their options.
• Swing position picker - the swing chip now shows the active swing position, and a long-press opens a picker of the entity's real swing options, so vane-position units can jump straight to a position instead of only cycling. The chip updates the moment you tap.

Fixed

• Swing now works on climate entities whose swing options are vane positions (for example MelCloud / Mitsubishi ["Auto", "1".."5", "Swing"]) or use a capitalized Off, which previously left the chip unresponsive. Midea and other switch-backed swing controls are unaffected.

No breaking changes.

Updating: update the card in HACS, then hard-refresh your browser (Ctrl+F5 / Cmd+Shift+R) so the new build loads.

Full Changelog: v1.2.1...v1.3.0

v1.2.1

Fixed (touch)

• Touch center tap on iOS (iPhone / iPad) now reliably opens the mode pop-up instead of leaving a focus outline with no pop-up.
• Vertical swipes anywhere on the card now scroll the dashboard, except on the two arc rings, which still drag to set temperature and fan.
• The center no longer flashes a focus square on tap.

Touch-only fixes, no config changes, safe to update via HACS.

What's Changed

• docs: refresh README to v1.2.0 and add release version-bump checklist by @rickyfont94 in #31
• docs: compact screenshot tables and collapsible screenshot sections by @rickyfont94 in #32

Full Changelog: v1.2.0...v1.2.1

v1.2.0

New features

• New appearance option to choose the card background: theme (default, follows the active Home Assistant theme) or a translucent frosted-glass panel in a dark (glass-dark) or light (glass-light) finish that frosts the dashboard wallpaper behind it.
• New glass_color and glass_opacity options to tint the frosted-glass panel and set how solid it is (0 clear to 1 solid). Both apply only to the frosted-glass appearances.
• Light-theme legibility for the hint labels and ticks, so the MODE / FAN / AUTO gesture hints and the numbered tick scale stay readable on light themes.
• New editor "Reset styling to defaults" button.

Bug fixes

• The FAN gesture hint no longer washes out the outer arc where the two overlap.
• The thin setpoint numerals now stay legible on the frosted-glass and light backgrounds.
• The current-temperature marker is no longer invisible against the light arc.
• The MODE and NOW labels are easier to tell apart.
• The setpoint needle now follows the mode color instead of always rendering orange in cool mode.

No breaking changes.

v1.1.0

Theming, localization, configurable actions, broader entity support, and a batch of bug fixes. A minor release with no breaking changes.

New features

• Follows the active Home Assistant theme (light and dark) via ha-card, while accent, mode_colors, and font stay overridable.
• Configurable tap_action, hold_action, and double_tap_action on the center disc, with an Actions section in the GUI editor. Tap opens the mode menu by default and hold opens more-info.
• Discoverable gestures: faint MODE / FAN / AUTO hint labels (toggle with show_hints) and a press-feedback highlight on the center disc.
• English and Spanish localization, auto-selected from the Home Assistant language.
• The fan ring now works with non-Midea climate and fan entities, honoring the entity's real range or fan_modes.
• Correct sizing in Sections-view dashboards.

Bug fixes

• The gauge no longer vanishes when an entity's minimum and maximum temperatures are equal or inverted, and the editor now warns when min is not below max.
• Whole degrees drop the trailing .0.
• The Show choice for the swing, LED, and sound chips now forces the chip visible.
• The card font falls back to the theme font.

No breaking changes, safe to update via HACS.

v1.0.6

What's Changed

• ci: bump softprops/action-gh-release from 2 to 3 by @dependabot[bot] in #1
• ci: bump actions/checkout from 4 to 7 by @dependabot[bot] in #2
• ci: bump actions/setup-node from 4 to 6 by @dependabot[bot] in #3
• Fix README behavior docs and version banner by @wenxiaojie1 in #26
• Critical bug fixes: keyboard a11y, heat_cool, touch, unit conversion, error handling by @rickyfont94 in #27

New Contributors

• @dependabot[bot] made their first contribution in #1
• @wenxiaojie1 made their first contribution in #26
• @rickyfont94 made their first contribution in #27

Full Changelog: v1.0.5...v1.0.6

v1.0.5

First public release of the Climate Cluster Card for Home Assistant.

A wide-arc, instrument-cluster climate card: drag the inner ring for temperature and the outer ring for fan speed, with a glass mode pop-up, swing / LED / sound toggles, a numbered gauge scale, and a full visual editor. Built for and tested with Midea (midea_ac_lan), and works with any climate.* entity. Vanilla single-file web component, no dependencies, no build step.

Added

• Wide-arc instrument-cluster climate dial for any climate.* entity.
• Two-ring control: inner ring sets target temperature, outer ring sets fan speed.
• Glass mode pop-up with per-mode glyphs and Swing / LED / Sound toggles.
• Numbered reference scale with a glowing setpoint needle and a current-temp marker.
• Clover fan animation that can spin proportional to the fan value, at a constant rate, or off.
• Fahrenheit and Celsius support with automatic unit, range, and step detection.
• Full GUI editor, no YAML required.
• Auto-discovery of fan / swing / LED / sound sibling entities, tuned for Midea (midea_ac_lan).

Installation

Install via HACS as a custom Dashboard repository, or download climate-cluster-card.js from this release and add it as a dashboard resource. See the README for full setup and all options.