Skip to main content

React Native Quickstart

The quickest way to start building Solana React Native dApps is to build off a starter template.

There are two starter templates for React Native:

  • Expo dApp Template
  • React Native dApp Scaffold

Expo is a development platform that simplifies the development, building, and deployment process for React Native.

The SDKs, references, and libraries for React Native are all compatible with Expo!

Quickstart Scaffolds

The Solana Expo dApp Template is a ready-to-go Expo dApp that offers:

  • Pre-installed core SDKs like Mobile Wallet Adapter and @solana/web3.js
  • Required polyfills like react-native-get-random-values and Buffer installed.
  • Simple React UI Components like ConnectWalletButton, RequestAirdropButton, SignMessageButton.


  • An Expo account.
  • React Native and Android Envrionment setup
    • An Android device/emulator.
    • Install an MWA compliant wallet app on your device/emulator.



Initialize the template using Expo's CLI tool:

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

The Expo CLI has issues when using other package managers like npm, npx or pnpm. Until fixed, use yarn to initialize the template app.

Choose your project name then navigate into the directory.

Build and run the app

Follow the "Running the app" section in the Expo Setup guide to launch the template as a custom development build.


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

  • Make sure you are building and installing an Expo development build NOT Expo Go. Follow the instructions here to build a custom development build.

TS2307: Cannot find module @solana-mobile/mobile-wallet-adapter-protocol or its corresponding type declarations.

  • This is a bug/issue when using npm. Until it is fixed, to mitigate, please install the project using yarn install, not npm install.

Further learning

To learn how to better use the core Solana React Native SDKs, check out these developer guides.