Solana Mobile Expo Template

This template is a ready-to-go Android Expo dApp that offers:

• Solana libraries: web3.js, Mobile Wallet Adapter, and spl-token.
• Required polyfills like crypto and Buffer configured.
• Pre-built React UI and re-usable hooks and code patterns like useMobileWallet.

This is only fully functional on Android.

Tech Stack

| Library | Category | Version | Description | | --------------------- | ----------------- | ------- | ----------------------------------------------------- | | React Native | Mobile Framework | v0.73 | The best cross-platform mobile framework | | Expo | SDK | v50 | Allows (optional) Expo modules | | React | UI Framework | v18 | The most popular UI framework in the world | | Mobile Wallet Adapter | SDK | v2.0 | Connect and request signing from mobile wallet apps | | Solana web3.js | SDK | v1.78 | General Solana library for transactions and RPCs | | spl-token | SDK | v0.41 | Library for building with Solana SPL tokens | | React Native Paper | Component Library | v18 | Production-ready components following Material Design | | React Navigation | Navigation | v6 | Performant and consistent navigation framework | | React Query | State management | v5.24 | Async query management | | TypeScript | Language | v5 | Static typechecking | | AsyncStorage | Persistence | v1 | State persistence |

Quick Start

Prerequisites

• A free Expo account.
• An Android device/emulator to test your app
  • Install an MWA compliant wallet app on your device/emulator.
• If using Expo's cloud service eas build, no further setup is required.
• If building locally:
  • React Native and Android Envrionment setup

Initialize

Run the CLI command:

yarn create expo-app --template @solana-mobile/solana-mobile-expo-template

Choose your project name then navigate into the directory.

Build and run the app

Once your app is initialized, follow the "Running the app" guide to launch the template as a custom development build.

Troubleshooting

• Metro has encountered an error: While trying to resolve module @solana-mobile/mobile-wallet-adapter-protocol...

  • This is an on-going issue when using npm install to install the Expo template.
  • To mitigate, clean your project dependencies and reinstall with yarn install

• The package 'solana-mobile-wallet-adapter-protocol' doesn't seem to be linked. Make sure: ...

  • Ensure you are NOT using Expo Go to run your app.
  • You need to be using an Expo custom development build, rather than Expo Go.

• failed to connect to...

  • This is an Expo error that can occur when trying to connect to the dev server on certain Wifi networks.
  • To fix, try starting the dev server with the --tunnel command (npx expo start --dev-client --tunnel)

• Error: crypto.getRandomValues() not supported

  • This is a polyfill issue when trying to use certain functions from the @solana/web3.js in a React Native/Expo environment.
  • To fix, ensure your App properly imports and uses the polyfills like in this guide.

• error Failed to load configuration of your project.
  • Same as above, but for yarn. Uninstall and reinstall the CLI through yarn.

• Looks like your iOS environment is not properly set:
  • You can ignore this during template initialization and build the Android app as normal. This template is only compatible with Android.

• Usage Error: It seems you are trying to add a package using a https:... url; we now require package names to be explicitly specified.
  • This error happens on certain versions of yarn, and occurs if you try to initialize the template through the Github repo URL, rather than the npm package. To avoid this, use the @solana-mobile/solana-mobile-dapp-scaffold package as specified, or downgrade your yarn version to classic (1.22.x).

• error Couldn't find the ".../@solana-mobile/solana-mobile-dapp-scaffold/template.config.js file inside "@solana-mobile/solana-mobile-dapp-scaffold" template.
  • This is a known error that occurs with certain versions of yarn (>= 3.5.0). It is fixed by running the cli command with the --npm flag or downgrading your version of yarn.