Skip to main content

Before you start

Set up your project and get an API key.

Flutter Wallets Example

See the full example app in the SDK repo.
1

Install the SDK

Run the following command to install the SDK:
2

Configure deep link scheme for OAuth

If you plan to use OAuth login (Google, Twitter), you need a deep link scheme so the browser can return to your app after authentication.Android — add to your AndroidManifest.xml:
android/app/src/main/AndroidManifest.xml
iOS — add to your Info.plist:
ios/Runner/Info.plist
If you only use email OTP login (no OAuth), you can skip this step.
3

Initialize the client and add providers

Create a CrossmintWalletProvider at the root of your app. This example uses Crossmint Auth but you can use any authentication provider of your choice.With the current setup, a wallet will be created automatically on login.See all supported chains here.
main.dart
Pass the API key via --dart-define when running the app:
For detailed configuration options, see the Flutter SDK Reference.
4

Allow users to login, logout, and access their wallet

Crossmint Auth in Flutter is headless — you build your own login UI and call the SDK directly. Use CrossmintWalletContext to access the auth client and wallet controller.
home_screen.dart

Launching in Production

For production, some changes are required:
  1. Create a developer account on the production console
  2. Create a production client API key on the API Keys page with the API scopes users.create, users.read, wallets.read, wallets.create, wallets:transactions.create, wallets:transactions.sign, wallets:balance.read, wallets.fund
  3. Replace your test API key with the production key
  4. Use your own authentication provider: For production applications, Crossmint recommends using third-party authentication with providers like Auth0, Firebase, or Supabase, rather than Crossmint Auth. Configure JWT authentication in the Crossmint Console under API Keys > JWT Authentication.

Learn More

Check Balances

Check the balance of a wallet.

Transfer Tokens

Send tokens between wallets.

Operational Signers

Register operational signers on a wallet.

API Reference

Deep dive into API reference docs.

Talk to an expert

Contact the Crossmint sales team for support.