Skip to content

feat(web): polish welcome and expand shortcut practice - #2879

Merged
tyler-dane merged 8 commits into
mainfrom
cursor/welcome-onboarding-polish-78e3
Aug 26, 2026
Merged

feat(web): polish welcome and expand shortcut practice#2879
tyler-dane merged 8 commits into
mainfrom
cursor/welcome-onboarding-polish-78e3

Conversation

@tyler-dane

@tyler-dane tyler-dane commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

Summary

Improves the welcome screen and first-run shortcut practice:

  • Welcome heading is The Keyboard Calendar; login chip is lowercase i; Hold+Mod stays on one line with “to see keys”; mouse FAQ matches the new copy.
  • Login and signup show the same always-visible shortcut chips as welcome (U / i / G / Enter) and those letters work when focus is not in a field.
  • Shortcut practice is a skippable six-mission game (create, hold-Mod jumps, S event jump, Shift+arrow nudge, E then T, Cmd+K) before graduation. Skip-to-signup is U so S can teach event jump. Hint chips no longer overlap button labels.

CI follow-ups on this branch: e2e drives “Do it for me” with D (trusted pointer clicks are blocked), and the unused PRACTICE_JUMP_TARGETS export is removed.

Simplicity

Practice still uses ephemeral sandbox state (no real grid stores). Auth reuses GoogleButton / ShortcutHint rather than a second hint system. Skip remains available on every mission. /simplify inspected the branch diff and made no further code change: per-mission branches and the auth letter listener are already the smallest surfaces.

Automated validation

bun run verify (merge-base origin/main):

Selected packages: web
Checks run: test:web, type-check, lint, knip, test:a11y, test:e2e
Checks skipped: (none)
✓ All checks passed

web: 2346 pass / 0 fail. Playwright e2e: 35 passed, including create-then-D through graduation and U skip-to-signup. GitHub Test/e2e/knip on c488755bc were green; this markdown-only ship-record commit should skip those jobs.

Independent review

Handoff: .agents/handoffs/2879.md

VERDICT: no confirmed findings
FINDINGS:
(none)

Test plan

  • bun run verify — web, type-check, lint, knip, test:a11y, test:e2e
  • GitHub checks on c488755bc: lint, knip, type-check, unit matrix, e2e, CodeQL, pr-body
Open in Web Open in Cursor 

cursoragent and others added 8 commits August 26, 2026 01:13
Rename the welcome heading to The Keyboard Calendar, show a lowercase i
for login, keep Hold+Mod+to see keys together, and update the mouse FAQ.

Co-authored-by: Tyler Dane <tyler-dane@users.noreply.github.com>
Match welcome: U/i switch the auth views, G starts Google, and Enter is
visible on the submit buttons. Letter shortcuts yield while typing.

Co-authored-by: Tyler Dane <tyler-dane@users.noreply.github.com>
Teach create, hold-Mod jumps, S event jump, Shift+arrow nudge, E then T,
and Cmd+K on a sandbox calendar. Remap skip-to-signup to U and keep
hints from overlapping button labels.

Co-authored-by: Tyler Dane <tyler-dane@users.noreply.github.com>
Use undefined instead of null when asserting the opened editor event id.

Co-authored-by: Tyler Dane <tyler-dane@users.noreply.github.com>
Wrap the full "Hold Mod to see keys, then press 1–5." phrase so the
meta icon cannot split the sentence across lines.

Co-authored-by: Tyler Dane <tyler-dane@users.noreply.github.com>
Playwright mouse clicks are blocked by pointer suppression, so the
showcase e2e now presses D per remaining mission. Drop the unused
PRACTICE_JUMP_TARGETS export that knip flagged.

Co-authored-by: Tyler Dane <tyler-dane@users.noreply.github.com>
Typed #2879 record for the verify gate after the e2e and knip fixes.

Co-authored-by: Tyler Dane <tyler-dane@users.noreply.github.com>
Verifier quoted bun run verify all-green; simplify made no code change;
independent review found no confirmed findings.

Co-authored-by: Tyler Dane <tyler-dane@users.noreply.github.com>
@tyler-dane
tyler-dane marked this pull request as ready for review August 26, 2026 01:43
@tyler-dane
tyler-dane merged commit 8241d1d into main Aug 26, 2026
16 checks passed
@tyler-dane
tyler-dane deleted the cursor/welcome-onboarding-polish-78e3 branch August 26, 2026 01:47
tyler-dane pushed a commit that referenced this pull request Aug 26, 2026
#2879 rebuilt the showcase underneath this branch: two steps became six
missions plus graduation, with a "Mission N of M" chip driven by a new
SHOWCASE_MISSION_IDS list.

The notifications offer now sits between the last mission and graduation,
and stays out of the mission list. It asks for a browser permission rather
than teaching a key, so numbering it "Mission 7 of 7" would have promised
a lesson it does not deliver; getMissionLabel returns null for it and it
renders no chip.

Consequences of the new neighbours, all resolved toward main's structure:
the practice side-letters D and U are gated to missions, since the offer
has no board action to assist with, and C no longer opens a practice draft
behind the offer. X still leaves from the offer, as it does everywhere.

Main also dropped the shortcut_tip_* product events; its list is kept and
the three notifications events append to it.

Tests follow the same split: main's mission walk is unchanged - which is
what proves the offer is not a mission - and gains the offer beat where it
hands off to graduation. Both e2e specs press D through the six missions
to reach the offer.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsQ9jUGnM7J2hUk3Kqx98F
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