1.1 KiB

Raw Permalink Blame History

Onboarding + Walkthrough hardening plan

Base branch: fix/refactor Working branch: fix/refactor-onboarding-walkthrough

Goals

Verify current onboarding and walkthrough flows are functional.
Fix edge cases for first-run, skip, replay, and recovery states.
Improve UX discoverability of walkthrough entry points.
Add regression tests to keep flows stable.

Phase 1: audit and test map

Identify current onboarding/walkthrough code paths.
Document triggers, persistence flags, and routing.
Add failing tests for first-run, skip, replay, and already-seen states.

Phase 2: implementation hardening

Fix state transitions and persistence updates.
Ensure walkthrough can be reopened from primary UI.
Add visible hint/help entry to improve discoverability.
Handle corrupted or partial onboarding state safely.

Phase 3: verification

Run targeted tests for onboarding/walkthrough.
Run full project checks.
Validate end-to-end flow manually in local dev.

Deliverables

Code changes in onboarding/walkthrough modules
Automated tests covering key onboarding paths
Updated docs/help text for walkthrough discoverability