Skip to content

docs(ux): track deferred UX-audit polish (dark-mode tail, IA, forms)#621

Merged
SoundMindsAI merged 2 commits into
mainfrom
chore_ux_polish_followup
Jul 11, 2026
Merged

docs(ux): track deferred UX-audit polish (dark-mode tail, IA, forms)#621
SoundMindsAI merged 2 commits into
mainfrom
chore_ux_polish_followup

Conversation

@SoundMindsAI

Copy link
Copy Markdown
Owner

Captures the low-severity remainder of the 2026-07-11 UX audit as a tracked idea file. The high/medium findings shipped across #616#620; this records what each of those PRs deferred so it isn't lost:

  • Dark-mode completion — sweep the ~49 text-blue-600 links + remaining bg-*-50 callouts to tokens/<Alert>; migrate the 3 charts off hardcoded hex + add axis labels/units; human dark-mode QA pass across every surface.
  • IA tail — empty-state CTA parity (studies/query-sets/templates); cluster-tree breadcrumb consistency; reverse "used by" links; resolve the query-set→cluster link to the cluster name.
  • Forms & polish — comprehensive aria-invalid/aria-describedby on the study wizard; a centralized formatDateTime(); per-list errorMessage/onRetry wiring on the DataTable.

Docs-only (one idea file under planned_features/02_mvp2/). No code change.

Closes nothing — this is the tracking artifact for the follow-up itself.

🤖 Generated with Claude Code

Follow-up remainder of the 2026-07-11 UX audit whose high/medium findings
shipped in PRs #616-#620: dark-mode long-tail color sweep + chart theming +
human dark-mode QA, empty-state CTA parity, breadcrumb consistency, reverse
"used by" links, wizard form-error association, and a centralized date
formatter. All low-severity; split out to keep each fix PR reviewable.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: SoundMindsAI <eric.starr@soundminds.ai>

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds a new planning document outlining a UX-audit polish follow-up, which details tasks for dark-mode completion, information architecture improvements, and form enhancements. The review feedback recommends expanding the planned formatting utilities to include a centralized formatNumber() helper alongside formatDateTime(), as some existing toLocaleString() calls in the codebase format numbers rather than dates.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

- Comprehensive `aria-invalid`/`aria-describedby` association across the large
study-creation wizard's fields (the small dialogs were done in #618; wizard
errors are announced via `role="alert"` but not yet field-associated).
- Centralized `formatDateTime()` util to replace the 37 ad-hoc

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

When planning to replace toLocaleString() calls with a centralized formatDateTime() utility, note that some toLocaleString() occurrences in the codebase are used for formatting numbers (such as doc_count.toLocaleString() in create-study-modal.tsx) rather than dates. It would be beneficial to clarify in the tracking description that only date-time formatting calls should be replaced, or suggest a companion formatNumber() utility to handle numeric formatting.

Suggested change
- Centralized `formatDateTime()` util to replace the 37 ad-hoc
- Centralized `formatDateTime()` and `formatNumber()` utils to replace ad-hoc

… review)

Signed-off-by: SoundMindsAI <eric.starr@soundminds.ai>
@SoundMindsAI

Copy link
Copy Markdown
Owner Author

Gemini's clarification accepted — updated the idea's formatter item to distinguish date-time (formatDateTime()) from numeric (formatNumber()) toLocaleString() calls and warn against a blanket replace.

@SoundMindsAI
SoundMindsAI merged commit 1fe3eb7 into main Jul 11, 2026
6 of 8 checks passed
@SoundMindsAI
SoundMindsAI deleted the chore_ux_polish_followup branch July 11, 2026 13:57
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