feat(ui): first-login onboarding tour — 4-step spotlight highlight, skip/prev/next/finish, replay from settings (v1.20 A) - #63
Merged
Conversation
…kip/prev/next/finish, replay from settings (v1.20 A)
This was referenced Aug 17, 2026
7 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
UI/UE 5th-round deepening — item A: first-login onboarding tour (rant
2026-08-17T20:46:57, v1.20).On first login (no
localStorage atp-tour-done), a lightweight 4-step tour guides the new user, spotlight-highlighting each area in order:#dash-stats) — balance / trends#view-marketplace) — browse / use models#view-sharing) — list idle keys to earn points#endpoint-card) — top-up, API Key, endpoint Base URLsImplementation — non-modal floating layer:
#tour-overlay: semi-dim backdrop (click = close)#tour-ring: accent outline highlight ring positioned viagetBoundingClientRect,tour-pulsebreathing animation (static underprefers-reduced-motion)#tour-pop: tooltip card — top-right 「跳过」, bottom 「上一步 / 下一步 / 完成」(becomes 完成 on last step), step countern / 4(data-tour-actiondelegation)switchView(view, {sync:false})— no history pollution); popup clamped to viewportatp-tour-done=1(never shown again)#tour-replay-btn→startTour())Esc priority: tour open → Esc closes tour first (before help panel / inline forms).
Docs:
docs/user-stories.mdv1.20 +ui/README.md「首次引导 tour 约定」. Verified by DOM-stub smoke test (27 assertions: trigger on first login, step content/counter, view auto-switch, ring positioning, finish→done, no re-trigger, skip/outside/Esc close + mark, prev boundary, replay button, CSS incl. reduced-motion),cargo test,cargo fmt --check.Rant (verbatim)
Related
2026-08-17T20:46:57.465428(projectaitokenpool, status in_progress; items B–G to follow)feat/ui-ue-round5-onboarding(per rant: 分支 feat/ui-ue-round5)Tests
node --check ui/js/app.jscargo test— 1 passedcargo fmt --check