Snow, Slopes & Loipen – Bergfex Just Got Better ❄️
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-drivenha-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.totalon the open sensor (e.g., the*_trails_opensensor). 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 asattributes.totalon the primary entity.
- The card now prefers
-
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.
- Support for legacy slope-total entities (
Migration / Upgrade Notes
- Update your Bergfex integration or sensor templates to expose totals via
attributes.totalon the primary sensors (recommended). - Rename any cross-country entities using the old
_open_kmsuffix to the new_trails_openpattern, or create template sensors mapping the old names to the new ones.- e.g.,
sensor.my_area_classical_open_km→sensor.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).
- e.g.,
- 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-formwith expandable sections for Display and Ski-only options. This reduces clutter and uses Home Assistant form components consistently.
- The editor now renders a single schema-driven
-
Localization
- New translation keys for operation status (
Open,Closed,Unknown) and editor group titles.
- New translation keys for operation status (
-
Tests & Types
- Unit tests and TypeScript types were updated. If you have downstream forks, please re-run tests and type-checking.