Skip to content

docs: Add comprehensive UI review for v4 platform (2026-04-26)#558

Open
IanMayo wants to merge 2 commits into
mainfrom
claude/ui-review-e2e-tests-gbO8f
Open

docs: Add comprehensive UI review for v4 platform (2026-04-26)#558
IanMayo wants to merge 2 commits into
mainfrom
claude/ui-review-e2e-tests-gbO8f

Conversation

@IanMayo
Copy link
Copy Markdown
Member

@IanMayo IanMayo commented Apr 27, 2026

Summary

Add a detailed UI review document capturing findings from a comprehensive walkthrough of the v4 platform's web-shell, Storybook components, and E2E test suites across multiple viewports and themes.

Changes

  • New review document (docs/ui-review-2026-04-26.md): A structured post documenting:

    • Review methodology and scope (web-shell, Storybook, E2E specs at 1280×720, 1440×900, 1920×1080)
    • Strengths identified (catalog filtering, storyboard UX, symbology, log panel, high-contrast theming)
    • 12 prioritized issues across P1 (trust/correctness), P2 (layout/UX), and P3 (polish/discoverability)
    • Punch list with effort estimates
    • Reproduction steps for the review
  • Evidence screenshots (32 PNG files): Supporting images covering:

    • Catalog interface and filtering
    • Analysis view at three resolutions
    • All four theme variants (light, dark, HC light, HC dark)
    • Storyboard, drawing tools, log panel, and tools panel
    • Component Storybook fixtures

Key Findings

Critical issues (P1):

  • Track colours not rendering in live data (vs. working in Storybook fixtures)
  • Properties form ignoring dark theme
  • High-contrast light theme header links unreadable
  • E2E flakiness in properties-screenshots suite

Layout issues (P2):

  • Default GoldenLayout split doesn't scale to wide screens
  • 720px-tall viewports hide Properties panel below fold
  • Catalog timeline/map preview not collapsible
  • Thumbnail size toggle non-functional

Polish gaps (P3):

  • Duplicate + icons on map toolbar
  • Active vs. disabled tools visually indistinguishable
  • LOG tab hard to discover
  • Filter type picker lacks grouping and descriptions

Notes

Review conducted against claude/ui-review-e2e-tests-gbO8f @ ce4a2d4 with 62 raw screenshots. VS Code extension surface inferred from shared-component theme variants (openvscode-server unavailable in session).

https://claude.ai/code/session_01V4L79QYEwu2dXztDNTfZPx

…yout

Walks the v4 UI end-to-end via web-shell + Storybook, captures 32 evidence
screenshots, and records 12 prioritised recommendations (P1×4 / P2×4 / P3×4)
covering live track-symbology drift, properties-form theme support, layout
scaling at extreme viewports, and discoverability polish.

https://claude.ai/code/session_01V4L79QYEwu2dXztDNTfZPx
@IanMayo IanMayo temporarily deployed to debrief-preview-pr-558 April 27, 2026 05:15 Inactive
Followed docs/project_notes/code-server-cloud-testing.md (one-liner
tests/e2e/scripts/cloud-e2e-setup.sh) to bring up code-server with the
Debrief extension and capture 4 VS Code screenshots. Adds 2 new findings
(P1.5 toast pile-up, P3.6 mixed loading states) and a P1.6 note that the
grey-track symbology bug reproduces in VS Code, confirming the regression
is in the shared MapView pipeline rather than the GoldenLayout host.
Updates the punch list to 14 items with a 'Surface' column.

https://claude.ai/code/session_01V4L79QYEwu2dXztDNTfZPx
@IanMayo IanMayo temporarily deployed to debrief-preview-pr-558 April 27, 2026 05:24 Inactive
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.

2 participants