Home screen widgets

Home-screen widgets

A resizable widget per unit, showing temperature, mode and a bold ON / OFF / OFFLINE badge. The whole widget is colourful while the unit runs and colourless when it is off, so a glance at the home screen is enough.

Power, temp − and temp + work without opening the app. Each tap runs a headless background task that reuses the app's normal API client and its Keystore-held credentials, performs the action, and refreshes the widget. Tapping the widget body opens the app; a placement dialog picks which unit a widget controls.

Widgets also refresh periodically in the background (WorkManager), so the badge does not go stale between taps.

Material You themed on Android 12+ with the system's dynamic colours, and a teal fallback on older devices.

They work against any Breeze Core version — they only use the standard state and control endpoints.

If a widget looks stuck

• Open the app once after installing. The widget and the car screen read a cached unit list; before the first launch there is nothing to show.
• A widget showing OFFLINE means the server did not answer, not that the unit is off — check the server the same way you would from Diagnostics.
• Aggressive battery optimisation on some vendors' Android builds will delay the periodic refresh. Taps still work: they run on demand.