Expo Starter

Getting Started

Starter template to build an onchain react native app with thirdweb and expo.

Features

- in-app wallets using phone number, email or social logins to create a wallet for the user

- smart accounts to sponsor gas

- connecting to external wallets like MetaMask via WalletConnect

- autoconnecting to the last connected wallet on launch

- reading contract state and events

- writing to the blockchain

Installation

Install the template using thirdweb create.

Get started

1. Install dependencies

pnpm install

2. Get your thirdweb client id

Rename the .env.example file to .env and paste in your thirdweb client id.

You can obtain a free client id from the thirdweb dashboard.

3. Prebuild the ios and android directories

Important

The thirdweb SDK uses native modules, which means it cannot run on expo GO. You must build the ios and android apps to link the native modules.

npx expo prebuild

This will create the ios and android directories.

4. Start the app

pnpm ios

or

pnpm android

To run this app, you'll need either:

- Android emulator

- iOS simulator

Troubleshooting

OpenSSL Error on Xcode 16

If using xCode 16, you may encounter a OpenSSL error when trying to build the app. This is because xCode 16 requires a newer version of OpenSSL than the one specified in the current app.json.

To fix this, change the version of OpenSSL specified in the app.json file to 3.3.2000.

- Open the app.json file

- Find the ios > extraPods section

- Set "version": "3.3.2000" for the OpenSSL-Universal pod

- Save the file

Then run npx expo prebuild to update the native modules with the new OpenSSL version and run the app again.