Skip to content

Snow, Slopes & Loipen – Bergfex Just Got Better ❄️

Choose a tag to compare

@github-actions github-actions released this 15 Jan 21:01

This release introduces a set of breaking changes and upgrades to align the card with recent changes in the Bergfex integration. The version jump from 1.2.0 → 2.0.0 reflects backwards-incompatible adjustments.

Make sure to update the Bergfex Snow Report Integration, too:
https://github.com/timmaurice/bergfex/releases/tag/2.0.0

Highlights

  • Totals (slopes / trails / lifts) are now read from sensor attributes (preferred) rather than separate legacy total entities.
  • Legacy slope-total entities (*_slopes_total_km / *_slopes_total) and other legacy key support removed.
  • Editor UX improved: display (Anzeige) and ski-only sections use ha-form-expandable (single schema-driven ha-form).
  • Status labels are localized (Open / Closed / Unknown).
  • TypeScript and tests updated to match the new APIs and naming.

Breaking changes

  • Totals

    • The card now prefers attributes.total on the open sensor (e.g., the *_trails_open sensor). If present, that attribute will be used as the total value.
    • The fallback behavior for separate explicit total entities has been kept for cross-country (*_classical_total_km, *_skating_total_km) when necessary, but slope/lift legacy "total" entities have been removed. For slopes and lifts, please expose totals as attributes.total on the primary entity.
  • Removed legacy entities and keys

    • Support for legacy slope-total entities (*_slopes_total_km, *_slopes_total) and several older sensor key names has been removed. Update automation or sensors that provide only legacy entity names to expose totals on the main entity attributes.

Migration / Upgrade Notes

  1. Update your Bergfex integration or sensor templates to expose totals via attributes.total on the primary sensors (recommended).
  2. Rename any cross-country entities using the old _open_km suffix to the new _trails_open pattern, or create template sensors mapping the old names to the new ones.
    • e.g., sensor.my_area_classical_open_kmsensor.my_area_classical_trails_open (or create a template sensor that points to the old entity state/attributes under the new entity_id used by the card).
  3. If you maintain dashboards or automations that referenced removed legacy total entities, update them to use the main sensor (and read totals from attributes.total).

Other changes

  • Editor

    • The editor now renders a single schema-driven ha-form with expandable sections for Display and Ski-only options. This reduces clutter and uses Home Assistant form components consistently.
  • Localization

    • New translation keys for operation status (Open, Closed, Unknown) and editor group titles.
  • Tests & Types

    • Unit tests and TypeScript types were updated. If you have downstream forks, please re-run tests and type-checking.