Files
Jon Culver 453e697973 Add systemSmall (Home Screen) support to the Gauge widget (#4741)
<!-- Thank you for submitting a Pull Request and helping to improve Home
Assistant. Please complete the following sections to help the processing
and review of your changes. Please do not delete anything from this
template. -->

## Summary
<!-- Provide a brief summary of the changes you have made and most
importantly what they aim to achieve -->

The Gauge widget has only ever offered `.accessoryCircular` (Lock Screen
/ watch-complication) because it originated as a watchOS-style
complication ported to the Lock Screen in #2830. Home Screen support was
never on the table there, so the limitation is an inheritance, not a
design decision.

WidgetKit renders gauges in `.systemSmall` fine, and the data path
(WidgetGaugeAppIntentTimelineProvider) is family-agnostic, so this is a
view-only change:

- Add `.systemSmall` to `WidgetGaugeSupportedFamilies.families`.
- Branch `WidgetGaugeView` on `\.widgetFamily`: the Lock Screen path is
unchanged; `.systemSmall` enlarges the existing gauge to fill a padded
square. The container background requirement is already satisfied via
the shared `widgetBackground` helper
(`containerBackground(_:for:.widget)`).

No new strings, no provider/intent changes, no other references to the
families list. Lock Screen behavior is byte-for-byte identical.

## Screenshots
<!-- If this is a user-facing change not in the frontend, please include
screenshots in light and dark mode. -->

<img width="480" height="480" alt="gaugeWidgetSystemSmallSnapshot light"
src="https://github.com/user-attachments/assets/657ef3a4-509b-4d8d-9f9f-35a2cb942a37"
/>

<img width="480" height="480" alt="gaugeWidgetSystemSmallSnapshot dark"
src="https://github.com/user-attachments/assets/4f5ed0c1-422b-48d8-8372-e8689b8eb253"
/>


## Link to pull request in Documentation repository
<!-- Pull requests that add, change or remove functionality must have a
corresponding pull request in the Companion App Documentation repository
(https://github.com/home-assistant/companion.home-assistant). Please add
the number of this pull request after the "#" -->
Documentation: home-assistant/companion.home-assistant#1351

## Any other notes
<!-- If there is any other information of note, like if this Pull
Request is part of a bigger change, please include it here. -->

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Co-authored-by: Bruno Pantaleão Gonçalves <5808343+bgoncal@users.noreply.github.com>
2026-06-18 18:05:04 +02:00
..