ObliviOS Developer portal Project site

Home / Decisions / ADR-116

Approve docs/superpowers/specs/2026-09-29-airpods-settings-ui-design.md.

Accepted, recorded 29 September 2026.

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.