Migration guides
Use these guides when upgrading Embedded Wallets SDK packages to the latest major version. Each guide consolidates breaking changes from older releases so you can upgrade directly to the current SDK in one pass.
Choose your platform
| Platform | Upgrade to | Covers upgrades from |
|---|---|---|
| Web (JavaScript, React, Vue) | v11 | v9 through v10 |
| Android | v9 | v4 through v8 |
| iOS | v10 | v6 through v9 |
| React Native | v8 | v3 through v7 |
| Flutter | v6 | v3 through v5 |
Each guide includes install steps, breaking changes grouped by version, a summary table, and platform-specific release notes.
AI-assisted migration
Every guide includes a copyable prompt for AI coding assistants (Cursor, Claude Code, Codex,
Antigravity, and similar).
For the best results, install the MetaMask Embedded Wallets skill and MCP server before you
migrate — see Build with AI for setup
(npx skills add web3auth/skill and MCP at https://mcp.web3auth.io).
Open the guide for your platform and paste the prompt from the AI-assisted migration section. Use planning mode (where available), review the plan before generating code, and do not change your Client ID or Sapphire network unless you intend to — that can change wallet addresses in production.