Upgrade from Web3Modal to Reown AppKit for Flutter#

This document outlines the steps to migrate from the old web3modal_flutter package to the new reown_appkit packages in your Flutter project.

Step 1. Replace the corresponding dependency#

Remove web3modal_flutter dependency from pubspec.yaml and add reown_appkit:

// Remove the code line belowweb3modal_flutter: ^X.Y.Zreown_appkit: ^1.0.0

Run flutter clean && flutter pub get after replacing the packages

Then replace the imports...

// Remove the code line belowimport 'package:web3modal_flutter/web3modal_flutter.dart';import 'package:reown_appkit/reown_appkit.dart';

Step 2. Update your AppKit's theme related classes#

Step 3. Update the main service class#

See more about how to initialize on Initialization section

Step 4. Update main buttons#

Step 5. Networks presets#

The way we used to manipulate the network presets has changed

// Remove the code lines belowW3MChainPresets.chains.addAll(W3MChainPresets.extraChains);W3MChainPresets.chains.addAll(W3MChainPresets.testChains);final testNetworks = ReownAppKitModalNetworks.test['eip155'] ?? [];final extraNetworks = ReownAppKitModalNetworks.extra['eip155'] ?? [];ReownAppKitModalNetworks.addNetworks('eip155', testNetworks);ReownAppKitModalNetworks.addNetworks('eip155', extraNetworks);

See more on Custom networks section

Step 4. Update your Components usage#

Update your web3app instance within the service:

If you use to subscribe to web3App events you should now change it to appKit. Example:

// Remove the code line below_w3mService.web3App!.getActiveSessions();_appKitModal.appKit!.getActiveSessions();

Same for anything related to _w3mService.web3App!...

Step 5. Update any exception type#

Final notes#

• Ensure that you have updated all relevant configurations and imports in your project to reflect the changes from Web3Modal to AppKit.
• Test your application thoroughly to ensure that the migration has been successful and that all functionality is working as expected.
• Check our AppKit example for Flutter to compare with your implementation in case you are having issues