chore: Create preview build for toast animation in TestFlight [do-not-merge]

[amandaye0h]

Description

This PR prepares a TestFlight preview build so design and engineering can QA toast animation and styling polish across the design system and feature surfaces on real iOS devices.

The branch includes iOS-style top toast animation updates for the DS legacy Toast and BaseNotification components, plus visual polish for feature toasts (Earn, Money, Perps, Predict, Ramp, Rewards, Quick Buy, and gas fee). Storybook stories are included for local dev review but are not loaded at runtime — the production app entry (Root) is registered so TestFlight testers get the full MetaMask app with toast changes applied in real flows.

Field	Value
Source branch	prototype/toast-testflight
Build name	main-rc
Build commit SHA	ca35a4a
Build version	8.3.0
Build number	5924
TestFlight group	MetaMask BETA & Release Candidates
Workflow branch ref	main

Changelog

CHANGELOG entry: null

Related issues

Fixes:

Manual testing steps

Feature: Toast animation and styling preview on TestFlight

  Background:
    Given I have installed the TestFlight build from this branch
    And I am logged into MetaMask Mobile on iOS

  Scenario: DS legacy toast appears with iOS-style top animation
    Given I trigger an action that shows a design-system toast (e.g. copy address, network switch)

    When the toast is displayed
    Then the toast should slide in from the top with the updated animation
    And spacing, typography, and icon sizing should match the polished design

  Scenario: feature toasts render with updated styling in real flows
    Given I navigate to a feature that shows a toast (Perps, Predict, Ramp, Earn, Rewards, or Quick Buy)

    When the feature triggers a success, error, or loading toast
    Then the toast should use the updated icon spacing, colors, and text styles
    And the toast should dismiss correctly without layout issues

  Scenario: app launches as full MetaMask (not Storybook)
    Given I open the TestFlight build for the first time

    When the app finishes loading
    Then I should see the MetaMask onboarding or wallet home screen
    And Storybook should not be displayed

Screenshots/Recordings

Before

N/A — preview build for on-device QA; recordings to be captured during TestFlight review.

After

N/A — preview build for on-device QA; recordings to be captured during TestFlight review.

Pre-merge author checklist

• I've followed MetaMask Contributor Docs and MetaMask Mobile Coding Standards.
• I've completed the PR template to the best of my ability
• I've included tests if applicable
• I've documented my code using JSDoc format if applicable
• I've applied the right labels on the PR (see labeling guidelines). Not required for external contributors.

Performance checks (if applicable)

• I've tested on Android
  • Ideally on a mid-range device; emulator is acceptable
• I've tested with a power user scenario
  • Use these power-user SRPs to import wallets with many accounts and tokens
• I've instrumented key operations with Sentry traces for production performance metrics
  • See trace() for usage and addToken for an example

For performance guidelines and tooling, see the Performance Guide.

Pre-merge reviewer checklist

• I've manually tested the PR (e.g. pull and build branch, run the app, test code being changed).
• I confirm that this PR addresses all acceptance criteria described in the ticket it closes and includes the necessary testing evidence such as recordings and or screenshots.

Made with Cursor

[github-actions]

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.

[mm-token-exchange-service]

PR template — items to address before "Ready for review"

Warnings — informational, address before merging:

• Related issues section is empty. Add Fixes: #123 / Closes: <URL> / Refs: <Jira key>, or write a short rationale after the colon.

See docs/readme/ready-for-review.md for the full Definition of Ready for Review.

[sonarqubecloud]

Quality Gate passed

Issues
13 New issues
0 Accepted issues

Measures
0 Security Hotspots
81.1% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud