Repository navigation
Conversation
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>
… 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
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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.
Round by round (overall; a dash means that judge did not score the round):
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
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.CategoryIconmaps Apple's data categories;VerdictIconthe keep / replace / remove choice;PRESET_ICONthe privacy-profile presets.aria-labelstill carry it).Hierarchy
/apps/:id, and the Apps count now shows on every route (it was fetched only on two).Consistency
.severity-badge,.app-card-profile-badge, the mismatch count).Colour and surfaces
--surface0.04 to 0.06,--surface-20.06 to 0.075, borders 0.07 / 0.13 to 0.06 / 0.11, so a card is read by its tone first.--surface0.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.Clarity and copy
Structural (rounds 5 to 7)
The four changes every judge flagged in every polish round, made after sign-off:
.site-footerinAppChrome), in the flow under the content. Both components keep their classes and flags./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.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.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:
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:i18nparity (zh.jsonedited alongsideen.json), the focusednode:testsuite (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.e2e-rustcaught 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.NavandRequireAppsGatesent 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).qualityandrust-checkfail 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.🤖 Generated with Claude Code