Skip to content

UI simplicity and focus pass - #8

Merged
Ben-K-Jordan merged 1 commit into
mainfrom
claude/session-link-generation-SCkSf
Jul 17, 2026
Merged

UI simplicity and focus pass#8
Ben-K-Jordan merged 1 commit into
mainfrom
claude/session-link-generation-SCkSf

Conversation

@Ben-K-Jordan

Copy link
Copy Markdown
Owner

Implements every finding from a live UI review (all screens screenshotted at laptop and phone widths with real data) judged against one goal: a simple UI that promotes focus. Net diff removes more than it adds.

Session runner (sacred focus time)

  • Fixed the worst offender: during review, the prompt card showed the NEXT question while the feedback belonged to the one just answered. The card now snapshots the answered prompt until you advance.
  • A wrong answer could stack up to 8 differently colored callout boxes. All callouts now share one border color (only their small labels keep an accent), the two reflection inputs collapse behind one "+ Add a reflection" link, and the hypercorrection alert is the only accent-colored box when it appears.
  • The model answer stays visible (dimmed) while you write an error log, instead of vanishing right when you need it.
  • The progress bar never jumps backward when a repair prompt is injected; a quiet "+1 repair added" note explains the count change.
  • Removed the mid-session score tally (the end screen owns the numbers), hid the Ctrl+Enter hint on touch screens, shortened the repeated diagnostic banner after its first appearance, and stripped raw markdown markers from feedback excerpts.

Navigation and chrome

  • During sessions the nav recedes to the brand plus a single quiet Exit link — no link grid, no badges.
  • Top-level nav consolidated from 7 destinations to 4 (Dashboard, Learn, Plan, Settings); Flashcards, Guides, and Chat are one tap away via Learn's quick actions (reachability verified before removal).
  • The Mock AI pill moved out of everyone's eyeline into Settings; the unconfigured Google Calendar section is now one plain sentence instead of env-var instructions.

Dashboard

  • Today's sessions are the first thing on the page, and Start is the page's only filled primary button.
  • Five stat cards collapsed into one quiet text strip; the milestone bar removed (the achievements page already shows per-badge progress); the heatmap moved to the bottom.
  • A brand-new account sees just a welcome card with "Create your plan" instead of five zeros and an empty heatmap.

Learn, plan, end screen

  • Learn is no longer a second dashboard: stat cards, due-cards banner, and XP footer deleted; the recommendation card is the hero; the learning-path checklist hides once its first steps are done. Also fixed the deck-count disagreement between Learn and the flashcards page (the flashcards list was over-filtering by exam).
  • The upload drop zone no longer renders as a glaring white box in the dark theme; plan card subtitles clamp to one line.
  • The end screen's duplicate SCORE BREAKDOWN section is gone and "Schedule follow-ups" is now a quiet button inside the list it schedules, leaving one primary CTA.

Verification

  • tsc --noEmit clean
  • 646 unit tests passed, 137 integration tests passed
  • Full e2e after production rebuild: 57 passed, 15 skipped (baseline), including updated assertions covering the review-snapshot behavior and the repair-added note

Generated by Claude Code

Session runner: the prompt card now snapshots the just answered
question during review, so feedback and question always match instead
of showing the next prompt above the previous prompt's feedback. All
review callouts share one border color with only their small labels
accented, and the two reflection inputs collapse behind a single add a
reflection link, so a wrong answer no longer stacks eight competing
colored boxes. The model answer stays visible, dimmed, while writing
an error log. The progress bar never regresses when a repair prompt is
injected and a quiet note announces the addition. The running score
tally is gone from the status line, the keyboard hint hides on touch
screens, the diagnostic banner shows its full text only once per run,
and feedback excerpts strip raw markdown markers.

Navigation: during sessions the nav recedes to the brand plus a single
Exit link. Top level destinations consolidated from seven to four
(Dashboard, Learn, Plan, Settings); Flashcards, Guides, and Chat are
reached from Learn's quick actions. The Mock AI pill moved from the
nav into Settings as a one line note, and the unconfigured Google
Calendar section collapses to a single sentence without env jargon.

Dashboard: Today is the first section and Start is the page's only
filled primary button. The five stat cards collapse to one quiet text
strip, the milestone bar is gone (the achievements page already shows
per badge progress), the heatmap moves to the bottom, and a first run
shows only a welcome card with Create your plan.

Learn: the stat card row, due cards banner, and XP footer are gone;
the recommendation is the hero and the learning path hides once its
first steps are complete. Mode labels render in sentence case. The
flashcards page now lists decks by course only, matching how Learn
counts them, so the two pages can no longer disagree.

Plan and end screen: the upload drop zone no longer renders as a white
box in the dark theme, plan card subtitles clamp to one line with the
same two objectives plus N more rule everywhere, the end screen's
duplicate score breakdown section is deleted, and Schedule follow-ups
is a quiet button inside the list it acts on. Chat's page title
matches its nav label.
@Ben-K-Jordan
Ben-K-Jordan merged commit 1f7208f into main Jul 17, 2026
4 checks passed
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