Files
pipelines/app/notes/chat-ui-clarity.md
T

3.4 KiB

Chat UI clarity follow-up

Addresses the independent screenshot review of the populated chat workspace.

  • Mobile inactive panes have a persistent chat title and explicit Switch action, a divider grip, and a separate transcript viewport. Remembered peek bounds and Tape default are preserved.
  • Code blocks and tables expose actual horizontal overflow with native persistent scrollbars, a directional cue, keyboard focus/arrows and semantic actions.
  • Chat headers reserve their own viewport rather than covering scrolling content. Model and permission values remain readable in narrow panes and with enlarged text. Exceptionally short headers scroll to keep controls reachable.
  • Chat identity colors remain stable; Active/Visible and Working/background/New are separate textual or shaped states. Compact rows retain attention badges, identity initials and full-context tooltips. Tested metadata/state contrast is at least 4.5:1 across 64 native palette/identity combinations; this is not a complete accessibility audit.
  • Main navigation has captions. Compact chat navigation exposes a labeled Menu with all destinations and returns without discarding chat state or drafts. Caption taps preserve text-field focus. Lists now reserve the measured bottom navigation viewport, so the last row can scroll fully clear. Compact buttons explicitly expose their complete state label to assistive technology.
  • Measured low-contrast Cupertino report/completion/placeholder text now uses native label colors. Covered states exceed 4.5:1 in light/dark; disabled controls retain their native appearance (see cupertino-chat-readable-text.md).

Verification

  • Final integration: 1,590 tests passed across chat, settings, motion, adaptive UI, shell and application (/tmp/memwatch/out.1m52Wq).
  • Final header/text-scale and caption-focus changes: 13 tests passed (/tmp/memwatch/out.EtZ7az). Final analyzer clean (flutter-analyze.w3d4G0).
  • Real browser full-app fake-gateway captures: Material dark mobile and desktop, Material light desktop and Cupertino light mobile. Compact Menu navigation, Tape switching and inactive transcript bottom were exercised. Fixtures only; no real chats or runs were modified.
  • Captures: /tmp/review/chat-clarity-desktop-release, /tmp/review/chat-clarity-light, /tmp/review/chat-clarity-phone, /tmp/review/chat-clarity-cupertino-release.
  • No native device test or installation was performed. The personal Fold remains delivery-only. Web and APK deployment are tracked separately from code checks; these client changes require no server restart.

Independent follow-up

The reviewer found the named peek, overflow cues, readable settings values, state labels and navigation substantially improved. Their sidebar overlap finding led to the reserved list viewport. Header/transcript bounds were then verified before and after scrolling in both hosts (10 tests, /tmp/memwatch/out.NCeUnQ). Compact-state recognition remains a usability question beyond screenshot review; full hover and accessible labels are verified. Repeated overflow instructions trade some vertical space for discoverability; no claim of a full usability or accessibility audit is made.

Final independent capture check confirmed the sidebar row/metadata/menu fully clear navigation and darker Cupertino text is readable, with no new blocking visual issue apparent in those two captures.