> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solanamobile.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Solana Expo dApp Template

export const Button = ({href, children}) => {
  return <div className="not-prose group mt-3">
      <a href={href}>
        <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-xl group-hover:opacity-[0.9] font-medium">
          <span>{children}</span>
        </button>
      </a>
    </div>;
};

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

* Pre-installed standard 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`.

<Button href="https://github.com/solana-mobile/solana-mobile-expo-template">
  View on GitHub
</Button>

## Prerequisites

* An [Expo](https://expo.dev/) account.
* React Native and Android Envrionment [setup](/get-started/development-setup)
  * An Android device/emulator.
  * Install an MWA compliant wallet app on your device/emulator.

## Usage

### Initialization

Initialize the template using Expo's CLI tool:

```bash theme={null}
yarn create expo-app --template @solana-mobile/solana-mobile-expo-template
```

<Note>
  **INFO**

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

Choose your project name then navigate into the directory.

### Build and run the app

Follow the **["Running the app"](/react-native/expo#running-the-app)** section in the Expo Setup guide to launch the template as a custom development build.

## Troubleshooting

`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](/react-native/expo#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`.