ObliviOS Developer portal Project site

Home / Decisions / ADR-141

The Launcher3 app drawer applies the home screen's themed icons.

Proposed, recorded 6 October 2026.

Decision
ADR-141
Date
2026-10-06
Status
ProposedProposed (patches 0011 and 0012 are in ADR-155)
Part
App drawer
Mentions
ADR-142, ADR-155
Mentioned by
ADR-142, ADR-144, ADR-155, ADR-183

1Decision

The Launcher3 app drawer applies the home screen's themed icons (BubbleTextView.shouldUseTheme() also true for DISPLAY_ALL_APPS) and groups apps automatically into category cards by ApplicationInfo.category, fixed groups, apps without a category in Other, as category containers with a frosted glass opened group (title only), as patches on upstream Launcher3 (ten, below). ADR-142 adds the System group and removes the three fixed per-package overrides.

Design: app drawer theming and categories.

Patches of sovereignos-platform launcher/app-drawer/patches/packages-apps-launcher3/: 0001 themed icons in the drawer, 0002 grouping logic and its unit test, 0003 group items, container view, opened card and adapter wiring, 0004 fixes after the first device round (space above each container, an app starting from its icon in the open card, the stock folder icon size in the card, the grip), 0005 a group rebinding on every update so its icons follow the theme, 0007 a group loading a missing themed icon in the background, so an app without a monochrome icon follows the theme too, 0008 the opened group readable in the dark theme and with a large font, 0009 the icon cells of the opened group sized by their label (a regression of 0008's first form, found on the device), 0010 the fixes of the code review before the next image (accessibility counts, the opened card's pre-draw race and touches during its animation, no category read for a system app).

0006 is named by ADR-142.

2Why and evidence

Owner request 2026-10-06 (chat): the drawer ignores the owner's icon theme and is one flat list; the owner judged the result on lynx good on 2026-10-07 (chat; evidence DRW-001 to DRW-015). Source shows the drawer is excluded from theming by upstream code, and generated monochrome icons already work on the home screen. Editable groups, manual folders, a card grid, native folder icons, a floating card and a bottom sheet were offered or drawn and not chosen.

3Consequences

Ten display-only patches that diverge from upstream and must be rebased on each upstream release. No IPC, permission or network change. Rollback is a build without the patches. The blur cost on lynx is small (DRW-007: 0.81 % janky frames); a code review before the sixth image found and fixed the accessibility counts and a pre-draw race.

4Review when

A DRW-* row fails; the patches stop applying after an upstream update. Accepted when the rows that are NOT_RUN (DRW-001 and DRW-007 and DRW-011 on stallion, DRW-008 work tab and Private Space, DRW-012 to DRW-015) have evidence or the owner waives them.

Read from docs/governance/decision-log.md, entry ADR-141.