- Decision
- ADR-116
- Date
- 2026-09-29
- Status
- AcceptedAccepted (design only; nothing built)
- Part
- AirPods
- Mentioned by
- ADR-117, ADR-121
1Decision
Approve docs/superpowers/specs/2026-09-29-airpods-settings-ui-design.md: the AirPods UI uses Android's own Settings components and tokens (SettingsLib expressive), hybrid (native device-page entries plus our own pages built from the same components), follows the system theme (dark and light) and dynamic colour, has no hard-coded text or colour, uses flat white vector artwork (one earbud mirrored, one case) and a custom 24 dp line-icon set.
2Why and evidence
Owner review over several rounds rejected every custom look (the legacy Guardian look, a custom "Instrument" language, realistic product renders, icon-heavy mode buttons) and chose exactly the Settings app's own style. Tokens were read from the pinned tree, not assumed: page SurfaceContainer, rows SurfaceBright, 20 dp / 4 dp group corners, 72 dp rows, BluetoothBatteryIndicator header (80x90 dp, 6 dp stroke, 300 degree arc), connected tonal toggle group, expressive switch, and @android:color/system_* dynamic roles for every colour.
3Consequences
Pages are built with SettingsLib expressive preferences, not hand-written Compose, so they follow system colour, font scale, language and RTL by construction. All strings are Android resources.
Findings recorded as open decisions, not resolved: O1 the native multi-toggle item (ToggleInfo) requires an icon per button while the owner wants none on this control; O2 registering the device-settings provider needs BLUETOOTH_PRIVILEGED for setMetadata, a broad new permission that needs its own justification and review; O3 several unread or approximate values (title size, category colour, level greens, sheet surface); O4-O6 tooling and renderer questions.
New validation cases AIR-033 to AIR-035. Follow-up UI (Quick Settings tile, notification, widgets, Find flow, remaining pages) needs its own design.
4Review when
Re-verify when a rebase changes SettingsLib's expressive theme, the DeviceSettings framework, or BluetoothBatteryIndicator; if O1 ends with visible mode icons; if the owner changes the theme or colour decisions.
Read from docs/governance/decision-log.md, entry ADR-116.