Skip to content

UI polish overhaul - #398

Open
adamXbot wants to merge 9 commits into
mainfrom
feat/ui-polish-rating-e229b1
Open

adamXbot wants to merge 9 commits into
mainfrom
feat/ui-polish-rating-e229b1

Conversation

@adamXbot

@adamXbot adamXbot commented Nov 7, 2026 •

Copy link
Copy Markdown
Collaborator

A scored polish pass over the nine screens a new user meets first and the one power users live in, in light and dark: dashboard (top and lists), apps grid, app detail (top and labels), privacy map, stats, settings and welcome. Rounds 1 to 4 are polish only (tokens, type, colour, icons, copy). Rounds 5 to 7 make the four structural changes every judge kept asking for, each approved before it was made; nothing else about navigation or behaviour changes, and class names are unchanged.

Method

Fixed captures (1440x900, the live AU top-10 apps seeded once and kept), three reviewer models scoring eight categories against GitHub (issues list, pulse), the Apple App Store (product page, privacy labels) and the Tailwind Catalyst demo (home, settings), fixes to what the judges agreed on, token first, then re-capture and re-score. Sonnet paced rounds 1 to 3; the full council scored the baseline and rounds 4 to 7. The judges never saw the target. Fable is also the model that made the fixes; it ran as a fresh read-only agent each time and did not pace the climb.

Scores

Round 7 (final), every judge; baseline in brackets.

category Fable Opus Sonnet
hierarchy 8.0 (6.5) 8.0 (6.0) 8.5 (6.5)
typography 8.0 (7.0) 8.0 (6.5) 8.5 (7.0)
spacing layout 8.0 (7.0) 7.5 (6.5) 8.5 (6.5)
colour contrast 8.0 (7.0) 8.0 (6.5) 8.0 (6.5)
iconography controls 7.5 (5.5) 7.5 (5.5) 8.0 (5.5)
consistency 7.5 (6.0) 7.5 (5.5) 8.5 (6.0)
clarity 8.0 (6.5) 7.5 (6.0) 8.0 (6.5)
character 8.5 (7.5) 8.0 (7.0) 8.5 (7.0)
overall 8.0 (6.5) 7.5 (6.2) 8.3 (6.5)

Round by round (overall; a dash means that judge did not score the round):

round what changed Fable Opus Sonnet lowest category
0 baseline 6.5 6.2 6.5 5.5
1 icons, badges, surfaces - - 7.0 6.5
2 hierarchy, hero facts, stats - - 7.5 7.0
3 settings, copy, light mode - - 7.5 7.5
4 contrast fixes from the gate 7.5 7.5 7.5 7.5
5 the four structural changes 8.5 8.0 8.0 7.5
6 sticky-bar fade (regressed) 7.5 7.5 7.7 7.5
7 welcome fits the viewport 8.0 7.5 8.3 7.5

Reference anchors on the same scale, round 7: Catalyst 8.5 to 9.0, GitHub 8.5, App Store 8.0 to 9.0. The target was 9.0 from every judge in every category; it was not reached. From round 4 on the council sits in a 7.5 to 8.5 band, and the findings that remain shared are information-architecture and product items (listed under Beyond polish), not polish.

What changed, by category

Iconography and controls

  • One line-icon set (app/components/icons/, 24-unit grid, 1.6 stroke, currentColor) replaces the emoji that stood in for icons: nav bell, settings sidebar, privacy-map category tiles, focus pills, dashboard section headers, decision cards, change-review buttons, the trust card, stats empty state and export buttons, the welcome "Keep it simple" tile, and now the check-up steps. CategoryIcon maps Apple's data categories; VerdictIcon the keep / replace / remove choice; PRESET_ICON the privacy-profile presets.
  • Card icon buttons rest in the tertiary colour and come up with the card; the floating sync count is gone (the title and aria-label still carry it).
  • The date-format and reminder selects take the control voice (36px, hairline border, small radius).

Hierarchy

  • Nav and settings-sidebar selection is a tint with accent text, no outlined box; Apps stays selected on /apps/:id, and the Apps count now shows on every route (it was fetched only on two).
  • The apps header keeps one filled primary (the nav's Add Apps); Sync All is the one outlined control and the library tools sit in one segmented group (see Structural).
  • Dashboard overview: labels 13px muted under 32px/600 tabular values, zeros muted, "Review & decide" an accent link with an arrow, "All N apps" an accent link, and the row no longer repeats "Ready to review" beside it.
  • Stats KPI numerals in the text colour; red only for apps off your profile, orange only for a pending count; one accent for the bars.

Consistency

  • One badge voice: 12px/600 sentence case (.severity-badge, .app-card-profile-badge, the mismatch count).
  • Hero facts (synced, version, price, age rating, first seen) share one neutral 26px chip; only the changes pill keeps a tint.
  • Tab suffixes are one muted style with a middle dot, no parentheses.
  • The date hook seeds with the stored preference (or the default) instead of ISO, so a date no longer paints two ways on one page; change-row dates are sentence case.
  • One 3px rail pattern across the dashboard lists (risk rows red, mismatch rows rose); change-review rows are one flat tint per severity, the gradient washes are gone.

Colour and surfaces

  • Dark: --surface 0.04 to 0.06, --surface-2 0.06 to 0.075, borders 0.07 / 0.13 to 0.06 / 0.11, so a card is read by its tone first.
  • Light: --surface 0.7 to 0.85 and a resting shadow on cards; the nav is near-opaque (0.97) in both modes so content no longer blurs through it as a halo; the amber review panel is a tint, not a glow.
  • The welcome tiles in light mode lose the dark lip and grey gradient; an unselected tile in dark keeps a trace of the brand tint.

Clarity and copy

  • "Synced today" in plain text instead of a green chip; "Show apps" instead of "Tap to view" (now for assistive tech only, the chevron and tile remain); "Apple label definitions"; the stats empty state says what is true ("No label changes since your first scan").
  • Settings: one card-title size (the date-format card included), a 960px column, "What this turns on" as a plain list with a leading check, the group eyebrow that repeated the sidebar removed, the "(?)" help as an info icon.
  • Em dashes out of the sentences on these screens (welcome, decision card, check-up, profile hints, the cleanup tile).

Structural (rounds 5 to 7)

The four changes every judge flagged in every polish round, made after sign-off:

  1. A static footer. The two floating pills (keyboard shortcuts, site info) that covered the bottom of every screen now sit in a page footer (.site-footer in AppChrome), in the flow under the content. Both components keep their classes and flags.
  2. A sticky action bar on /welcome. The continue action sat below the fold at 1440x900. It is now a sticky bar at the foot of the card (.focus-purpose-actions), with Skip on the left and Next on the right. Round 5 clipped the tiles under it, round 6's fade read as a smear, so round 7 sizes the tiles so the whole page fits above the bar at 900px tall (tiles 300px min, 18px titles, 13.5px copy); the fade stays only as a 20px edge.
  3. One secondary group in the apps header. Five same-weight actions plus a duplicate Add Apps became Sync All (outlined) plus one segmented role="group" of library tools (Custom apps, Compare, Review queue, Select). The header's Add Apps is gone; the nav's is the one primary. The flag key is kept.
  4. Icon tiles for the check-up steps. The five step dioramas (animated scene SVGs that read as a broken sprite in a still) are now one 40px tinted tile with a line icon per step (TaskDiorama); the scene CSS is removed.

Beyond polish

Findings the judges still share in round 7; each is information architecture or product, not polish, and this PR does not make them:

  1. One vocabulary and one chip for the three label classes. They are named and coloured differently per surface: unlinked / linked / track on the dashboard, glyph-only chips on app cards, Data Not Linked to You / Data Linked to You on the map, "not collected" in mismatch sentences. One chip component driven from the severity tokens, everywhere a class is named.
  2. One concept has four names: "Profile mismatches" (apps filter), "Off profile" (stats), "Consider replacing" (dashboard) and "apps that cross your line" (check-up).
  3. Counts disagree across screens: the dashboard says "0 apps with unreviewed changes" and stats "0 apps changed" while an app's page shows "2 changes to review", because change events can predate the app's first-seen date (seeded or imported history). One source for that count, and a "before you added this app" label on such rows.
  4. The decision cards (Keep, Replace, Remove) as selectable options: border by default, accent border and tint when chosen, hover state. Today they read as static info cards.
  5. Labels first on the Privacy Labels tab. The tab opens on release notes and the trust card; the labels it is named for are below the fold.
  6. One filled primary per viewport, the nav included. The nav's Add Apps competes with each page's own primary; the judges want it accent-soft.
  7. Fewer info buttons: one per section on the map and the Most Collected Data list instead of one per row; native selects on the control token with the icon set's chevron; a one-line reason under each "Review & decide" row (needs the preview payload to carry it).

Judges and references

Judges: Claude Opus 5.5, Claude Fable 5.1, Claude Sonnet 5.5, each a fresh read-only agent with the same brief, screenshots and references. References: GitHub issues list and repository pulse, Apple App Store product page and privacy labels, Tailwind Catalyst home and settings, captured once in both modes.

Rounds: baseline plus seven rounds (the budget was six; the seventh fixed the regression round 6 reported). Round artefacts (captures, judge JSON, scorecards, sheets) are kept out of git under .polish/.

Checks

  • tsc --noEmit, Biome over the whole tree, lint:i18n parity (zh.json edited alongside en.json), the focused node:test suite (1167 passing), and the e2e accessibility gate (tests/e2e/a11y.spec.ts, 12 of 12 against a production build of the final tree). The gate caught five contrast cases over the run: in round 4 the lifted surfaces and the new selection tint had pushed four under 4.5:1 in dark mode (active nav and sidebar text, the heatmap filter pill, the bulk bar's uninstall action, the stats tooltip's severity label); in round 7 the change-review chip on its own tinted row measured 4.26:1 dark and 4.37:1 light, a failure the gradient wash it replaced had hidden from axe (gradients are unmeasurable, so axe reports them incomplete rather than failed). Each is fixed by mixing the hue 30% toward the text colour.
  • The full Playwright suite against a production build of the final tree: 161 passed, 22 skipped. The skipped tests are the visual net, which is local-only.
  • This suite was not run locally before the first push, and CI's e2e-rust caught two regressions from this PR. Both are fixed in the last commit. The welcome page's sticky action bar covered "Try with sample data", because its negative bottom margin pulled the footer underneath; the footer now renders above the bar. Nav and RequireAppsGate sent the same app-count request at once, so one simulated failure reached the badge instead of the gate; they now share one read (lib/app-count.ts).
  • The same commit fixes two more faults in that bar. It overflowed the page on phones, because it cancelled a fixed 48px of card padding, and the row scrolling beneath it ghosted through the blur, which is the smear Fable reported in round 7. It now tracks the card's padding and is opaque.
  • The round 7 scores predate that commit and were not re-judged.
  • quality and rust-check fail on dependency advisories that this PR does not touch. fix(deps): clear the npm and RustSec advisories that fail CI's audit steps #400 clears them.
  • Not run here: the visual net (local baselines only).

🤖 Generated with Claude Code

adamXbot and others added 5 commits November 7, 2026 22:16
One line-icon set (app/components/icons) replaces the emoji in the nav
bell, settings sidebar, privacy-map tiles, focus pills, section headers,
decision cards, change-review buttons, stats and the welcome tile.

Hierarchy and consistency: nav and settings selection is a 12 percent
accent tint with accent text, no border; Apps stays selected on a detail
page; the apps header keeps Add Apps and Sync All outlined with ghost
mode toggles; cards drop the green Today chip and the floating sync
count; badges are 12px sentence case; hero facts share one neutral chip;
the What's changed card spans its column when there is no device panel.

Colour: KPI numerals in the text colour (red only for Off profile,
orange only for a pending count); dark cards one surface step up with
quieter borders; light cards closer to white.

Settings: YOU eyebrow above its first card, one card-title voice, the
date-format card in it, feature chips with one check glyph, preset
descriptions on four lines, the (?) help as an info icon.

Copy: em dashes out of the welcome, decision, check-up and profile hint
sentences; "Synced today"; "Show apps"; "Apple label definitions".

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Round 2, judged at 7.5 by the pace judge: change rows draw their category
from the icon set and date in sentence case; the amber review panel is a
tint, not a glow; the nav glass is more opaque so content no longer blurs
through it as a halo; tab suffixes share one muted style with a middle
dot; the settings column is wider and the sidebar tint lighter; the stats
bars take one accent and the panels size to their content; the privacy
map's caption is for assistive tech only and its sensitive tag reads at
11px; card icon buttons rest in the tertiary colour; the hero's "Synced
today" is a neutral chip; the welcome tiles lose their dark lip in light
mode and reserve two title lines; the check-up art is 40px; the apps
header's Add Apps is a ghost duplicate of the nav's primary.

Round 3, not yet judged: the sync-count tab suffix drops its parentheses;
light-mode cards get a resting shadow; the nav is 93 percent opaque; the
date hook seeds with the stored preference or the default instead of ISO,
so a date no longer paints two ways; the "Consider replacing" count is
sentence case; the date-format card takes the card-title voice and a
36px select; the settings column is 960px; the overview's "All N apps"
is an accent link and row status is tertiary; Adjust is a secondary
button; stats bars are 10px at 80 percent accent on a visible track;
count chips carry an accessible name.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
… colour 8.0)

Settings loses the group eyebrow that repeated the sidebar heading, and
"What this turns on" reads as a list with a leading check rather than a
row of toggles. The dashboard overview no longer prints "Ready to review"
beside "Review & decide", and the "Consider replacing" rows carry the
same 3px rail as the risk rows, in the mismatch colour. The detail hero
artwork is 72px. The privacy map's info buttons come forward with the
tile. An unselected welcome tile keeps a trace of the brand tint in dark
mode. The stats empty state says "No label changes since your first
scan."

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The dashboard overview crops its artwork like every other tile: the
stored icon can be Apple's wide placeholder image, which the plain 36px
img squashed into a tiny glyph. The reminder select on the detail page
takes the same control voice as the date-format select. The stats empty
state's second line no longer tells a user with 38 syncs to start
syncing. The settings sidebar is 240px so no entry wraps, and the stats
bar rows' info buttons come forward with the row. CHANGELOG entry.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The e2e accessibility gate found three dark-mode cases the lifted card
surfaces and the new selection tint had pushed under 4.5:1: the active
nav and settings-sidebar text (plain --blue on its own tint, 4.1:1 in
light), the heatmap filter pill's secondary text on three stacked
surfaces, the bulk bar's "Mark uninstall" red, and the stats tooltip's
severity label. Each now takes its hue pulled toward the text colour,
or the primary text, which measures 5.3:1 and better in both modes. The
gate passes 12 of 12.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@adamXbot
adamXbot requested a review from AdamXweb as a code owner November 7, 2026 12:20
adamXbot and others added 3 commits November 8, 2026 10:27
… 8.5 / opus 8.0 / sonnet 8.0)

Four changes the judges ranked first in every round, made with the
user's go-ahead. The footer links are a static row at the end of the
page (.site-footer in the contentinfo landmark) instead of two pills
fixed over the content; the page container's bottom padding shrinks to
match. The welcome page's action row is a sticky bar at the bottom of
the card, with a fade above it and Skip beside Next. The apps header
keeps Sync All as the one outlined action and puts Custom apps, Compare,
Review queue and Select in one segmented group; the duplicate Add Apps is
gone (the nav carries it, and flag.appgrid.actions.add_apps stays as a
key so stored overrides still parse). The check-up steps draw one line
icon in a tinted tile; TaskDiorama's animated scenes and their CSS go.

Round 6 folds in what all three judges still shared: change rows show
the date alone (the time rides in the title) on a flat tint instead of a
fade; the hero's facts are one muted line with middle dots while the
status chips stay pills; the nav glass is 97 percent opaque; the header
group's items answer hover; zero KPIs recede; the reminder label is
14px; "Compare" loses its ellipsis.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…7.5 / 7.5 / 7.7)

Round 6's sticky bar faded the "Also useful" tiles under it at 1440x900,
which every judge read as clipping. The onboarding card now fits that
height: 32px top padding, 18px titles with two lines reserved, 13.5px
copy, 300px tiles, a 20px fade. Both extras sit above the bar on first
view and the three tile titles share one line. The review panel and its
"track" rows take flat tints in place of the last two gradients.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…t tint (council sonnet 8.3 / fable 8.0 / opus 7.5)

Nav fetches the app count itself when no page passes one, so the Apps
label no longer changes width between routes (Opus, round 7). The
linked-added change-review row is a flat tint like the others. With the
washes flat, axe could measure the severity chips on their own tinted
rows and found the track chip at 4.26:1 dark and 4.37:1 light (a gradient
wash is unmeasurable, which had hidden it), so the three chip colours
lean 30% toward the text colour: 4.8:1 and better in the worst stack.
a11y gate 12 of 12 on a production build of this tree.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The sticky bar's negative bottom margin pulled the next element under it, so Try with sample data could not be clicked. On /welcome the footer now renders above the bar, which leaves the bar as the card's last child.

The bar cancelled a fixed 48px of card padding, so on phones it overflowed and the page scrolled sideways. It now tracks the card's padding at each width. It is also opaque, because the row scrolling beneath it ghosted through the blur as a grey smear.

Nav's app count and RequireAppsGate sent the same request in one commit, so a failed read could reach the badge and leave the gate with a good answer. They now share one in-flight read.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant