Skip to content

Map and align Companion Apps widgets #233

Description

@bgoncal

Problem statement

Home screen and lock screen widgets in the two Companion Apps were built independently, so what a user can place on their home or lock screen depends on which phone they hold. iOS ships entities, energy, commonly-used entities, calendar, open page, custom, to-do list, Assist, gauge, details, sensors and scripts, a subset of which also support the lock screen accessory families; Android ships its own home screen set (button, entity state, template, media player, camera, to-do) with no directly equivalent lock screen story.

Even where both platforms nominally offer "the same" widget, the name, configuration flow, tap target, sizes, theming and refresh behaviour differ. No single inventory exists, so we cannot answer "does the other app have this?" without reading both codebases, docs and support answers drift per platform, and every new widget gets designed twice.

Community signals

No response

Scope & Boundaries

In scope

  • A complete inventory of every home screen and lock screen widget in both apps: name, available sizes/families, configuration options, tap behaviour, data source, refresh mechanism, theming, and OS version floor.
  • A cross-platform mapping classifying each entry as aligned, diverged, iOS-only, Android-only, or blocked by OS capability.
  • A shared naming and configuration vocabulary, aligned with existing frontend concepts where they apply.
  • Agreement on the canonical behaviour for diverged pairs, plus a per-platform gap list to hand to follow-up work.
  • Documentation restructured so a widget is described once, with per-platform notes and an explicit lock screen availability column.
  • Cross platform data migration plan

Not in scope

  • iOS Controls, Live Activities, watch complications, StandBy and CarPlay; Android Wear tiles and quick settings. Adjacent surfaces, separate opportunities.

Foreseen solution

No response

Risks & open questions

No response

Appetite

No response

Execution issues

No response

Decision log

Date Decision Outcome

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

No labels
No labels

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions