feat(ux): product/UX review implementation (onboarding, empty states, a11y, mobile kanban) #27

2026-07-12T04:27:13+02:00

cesnimda commented

2026-07-12 04:27:13 +02:00

Implements all items from the product/UX review: dashboard-first landing for authenticated users (with a real bug fix -- the initial redirect target was dead code), onboarding checklist, first-time empty states, Match Score vs Candidate Fit copy differentiation, Google sign-in self-serve copy, keyboard shortcut discoverability, per-view subtitles, Correspondence/Gmail review cross-links, mobile-friendly kanban, and a match-score-ring aria-label fix.

cesnimda added 3 commits 2026-07-12 04:27:13 +02:00

feat(ux): first-time onboarding, empty states, and copy fixes 58868fc2b6

Implements the six "propose first" items from the product/UX review:

- "/" now redirects to /dashboard instead of the empty /jobs table --
  a new user's first screen is now an overview with orientation, not
  a data table with zero rows and four filter dropdowns.
- Jobs table gets a real first-time empty state (distinct from "no
  results match your filters") pointing at Add Job and the bookmarklet,
  instead of a bare "No jobs found."
- Match Score card and Candidate Fit tab now each get a one-line
  caption explaining what they are and how they differ (deterministic
  keyword coverage vs. AI opinion) -- they previously sat side by side
  with no explanation of why there are two.
- Google sign-in hint now reflects self-serve signup when
  Auth:AllowRegistration is on, instead of always implying you need an
  existing linked account.
- Quick Search button now shows its keyboard shortcut (Ctrl+K / ⌘K)
  inline instead of being undiscoverable.

feat(ux): per-view subtitles, correspondence cross-links, mobile kanban, a11y 9615ee3f41

Continuing the product/UX review's deferred items:

- Every top-level view now gets a one-line subtitle under its title
  (Dashboard/Jobs/Kanban/Reminders/Correspondence/Gmail review) stating
  what that specific view is for, instead of navigation being the only
  signal of what each page does.
- Correspondence inbox and Gmail review queue cross-link to each other
  instead of being two unexplained flat sidebar items -- kept both nav
  entries (renaming/nesting risked breaking muscle memory) but made the
  relationship between them explicit in the UI itself.
- Kanban board switches to a horizontal scroll-snap row on phone-width
  viewports instead of stacking all 5 columns vertically, which meant
  a lot of scrolling to see anything past "Applied".
- Match-score ring gets an aria-label with the actual percentage --
  it was two nested decorative CircularProgress elements with no
  accessible text. (Keyboard-accessible status changes on kanban cards
  were already covered by the existing "..." menu -- no gap there.)

feat(ux): onboarding checklist, dashboard-first landing (fixed)

CI and Deploy / test (pull_request) Successful in 2m5s

Details

CI and Deploy / deploy (pull_request) Has been skipped

Details

d5d82cb528

Dashboard onboarding checklist: a dismissible card with 3 steps (add
CV, import first job, check match score), each linking straight to
where you'd do it. Auto-hides once both CV and a job exist; otherwise
persists per-user via localStorage until dismissed.

Fixes the actual authenticated-landing redirect to /dashboard: my
earlier commit changed App.tsx's inner Shell route for "/", which
turned out to be dead code -- the outer router claims "/" for
LandingPage first, so Shell's own "/" route is never reached on a
direct hit. The real redirect lives in LandingPage.tsx's post-auth-check
navigate() and LoginPage.tsx's post-login nextPath default; both now
point at /dashboard. Verified live: an authenticated visitor hitting
"/" now lands on Dashboard with the onboarding checklist visible,
confirmed via rendered page text and screenshot.

cesnimda merged commit 0cd1ba398e into main

2026-07-12 04:30:01 +02:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: cesnimda/jobtrackingapp#27