feat: implement wallet home onboarding steps functionality#28851
Conversation
|
CLA Signature Action: All authors have signed the CLA. You may need to manually re-run the blocking PR check if it doesn't pass in a few minutes. |
04edc92 to
a867595
Compare
5a4dbfc to
5039516
Compare
5039516 to
50cb995
Compare
50cb995 to
de1acf3
Compare
AI PR Analysis🚫 Merge safe: false | 🟡 Risk: medium
|
de1acf3 to
78d907f
Compare
…ng hold state in WalletHomeOnboardingSteps
…ask/metamask-mobile into TMCU-610-shadowbox-checklist-logic
…countGroupBalance component
…ts for improved onboarding flow
christopherferreira9
left a comment
There was a problem hiding this comment.
Looks good for QA
There was a problem hiding this comment.
Hey Patryk, we have another huge PR coming in from the RN upgrade, it will be merged today. Any chance we can wait until that is merged and then merge this?
Or could you create perhaps another branch and merge both: #29195 and make sure all checks pass as well?
Codecov Report❌ Patch coverage is Additional details and impacted files@@ Coverage Diff @@
## main #28851 +/- ##
==========================================
- Coverage 81.50% 81.50% -0.01%
==========================================
Files 5328 5339 +11
Lines 141146 141577 +431
Branches 32157 32265 +108
==========================================
+ Hits 115046 115393 +347
- Misses 18239 18287 +48
- Partials 7861 7897 +36 ☔ View full report in Codecov by Sentry. 🚀 New features to boost your workflow:
|
🔍 Smart E2E Test Selection
click to see 🤖 AI reasoning detailsE2E Test Selection: Performance Test Selection: |
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes and found 1 potential issue.
❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.
Reviewed by Cursor Bugbot for commit ee0f7bc. Configure here.
|




Description
Adds a wallet home post-onboarding checklist when aggregate balance is empty (homepage v1, mainnet, remote flag walletHomeOnboardingSteps): three steps with hero media and Rive transitions; Add on step 1 (no skip); Skip + primary on steps 2–3. While the tile is active (including the awaiting-balance shell after reopen), AssetDetailsActions stay hidden; the last step can await onCoordinatedFlowExit() so Wallet can run a curtain over the cluster before the flow completes.
Redux: walletHomeOnboardingStepsEligible (set from eligible first-time onboarding success, cleared on wallet delete), walletHomeOnboardingSteps.stepIndex, suppressedReason (null | flow_completed | account_funded). Selectors gate UI; account_funded also clears eligibility in the reducer. Migration 133 backfills the new fields for existing installs (132 on main remains the Tempo token-balance fix only).
Changelog
CHANGELOG entry: Added a postonboarding checklist on the wallet home when balance is empty
Related issues
Fixes: https://consensyssoftware.atlassian.net/browse/TMCU-610
Manual testing steps
Screenshots/Recordings
Before
After
postonboarding-steps-animations.mov
Pre-merge author checklist
Pre-merge reviewer checklist
Note
Medium Risk
Adds a new remote-flagged, stateful onboarding flow that changes Wallet home rendering and navigation timing; risk is mainly UI/Redux state coordination and migration/rehydration edge cases.
Overview
Adds a remote-flagged Wallet home post-onboarding checklist that replaces the balance row/empty state with a 3-step tile (fund/trade/notifications) when the user is eligible and has an empty aggregate balance, including Rive-driven transitions and deferred “advance after return” behavior.
Introduces new onboarding Redux state/actions/selectors (
walletHomeOnboardingStepsEligible,walletHomeOnboardingSteps, suppression reasons, and a session-onlyskipInitialBalanceWait), wires eligibility fromOnboardingSuccess, persists/migrates the new fields (migration135), and updates Wallet rendering to hide main action buttons during the flow and coordinate the last-step exit animation.Updates feature-flag plumbing to gate the flow via a new AB test flag (
homeTMCU610AbtestWalletHomePostOnboardingSteps), registers analytics mapping, and adds extensive unit/integration tests plus a Rive mock tweak to support assertions across remounts.Reviewed by Cursor Bugbot for commit ee0f7bc. Bugbot is set up for automated code reviews on this repo. Configure here.