Skip to content

Turn the welcome into a stepped guided tour - #271

Merged
it-rec merged 1 commit into
masterfrom
claude/ux-onboarding-tour
Jun 1, 2026
Merged

Turn the welcome into a stepped guided tour#271
it-rec merged 1 commit into
masterfrom
claude/ux-onboarding-tour

Conversation

@it-rec

@it-rec it-rec commented Jun 1, 2026

Copy link
Copy Markdown
Owner

What

Upgrades the onboarding from a single wall of tips into a short guided tour — one tip per step, with:

  • Back / Next navigation and a Skip tour shortcut,
  • clickable progress dots (jump to any step),
  • ←/→ arrow-key navigation,
  • a "N of 5" counter in the header.

Re-opening (from the Overflow Menu's "Welcome guide") always starts at step one.

Why

Follow-up to the onboarding overlay (#265, merged) — a paced, one-thing-at-a-time tour reads better than five tips at once and lets a returning player flip straight to the bit they care about.

Tests

Onboarding.test.jsx rewritten for the stepped flow (greet, forward/back, dot jump, finish, skip, re-open, escape). App smoke test green. Lint + build pass.

Screenshot

Step 3 of the tour — progress dots, Skip/Back/Next:

onboarding tour

Screenshot file included in this PR at docs/screenshots/ux/onboarding-tour.png.

Notes

Rebased directly onto master (the onboarding base #265 has merged) — the diff now shows only the tour upgrade and merges cleanly.

https://claude.ai/code/session_0166awMvVyFXuwEex3x7jDmM

Base automatically changed from claude/ux-onboarding to master June 1, 2026 07:50
The onboarding is now one tip per step with Back/Next, a Skip-tour shortcut,
clickable progress dots and arrow-key navigation, instead of a single wall of
tips. Re-opening starts at step one.
@it-rec
it-rec force-pushed the claude/ux-onboarding-tour branch from 5bf9737 to 7b898c7 Compare June 1, 2026 07:53
@it-rec
it-rec merged commit 7ddfd6c into master Jun 1, 2026
4 checks passed
@it-rec
it-rec deleted the claude/ux-onboarding-tour branch June 1, 2026 12:39
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