Expo Example App
This example demonstrates a complete Expo application with Turbopush integration, allowing you to test over-the-air updates in minutes.
What you'll see here
- QR Code Ready to Use - We have a pre-built APK ready for you to test immediately without building anything.
- Publish an update to your app and test it over-the-air.
- See how fast you can release an update to your users.
- Troubleshooting tips if you encounter any issues.
Quick Start
1. Clone the Repository
git clone https://github.com/turbopushdev/example-expo-turbopush.git
cd example-expo-turbopush
2. Install Dependencies
- npm
- yarn
npm install
yarn install
3. Log in to Turbopush
if you already did this before, you can skip this step.
- npm
- yarn
npx turbopush login
yarn turbopush login
This will open your browser to authenticate. Once authenticated, you can close the browser and continue with the next steps.
4. Create an app
- npm
- yarn
npx turbopush app add <app-name-android>
yarn turbopush app add <app-name-android>
Copy the Staging Deployment Key and keep it handy, you'll need it in the next steps.
5. Install App
- QR Code
- Build APP
QR Code Ready to Use
Want to test immediately without building? We have a pre-built APK ready for you. Simply scan this QR Code:
Scan this QR Code with your device:
Open your camera app and scan this QR code to install the app.
Don't want to build the app? We have a pre-built APK ready for you. Change the tab above to "QR Code" and simply scan and install the app.
cp .env.example .env
Open the .env file and paste the Staging Deployment Key you copied in the previous step.
- Android
- iOS
- npm
- yarn
npm run android -- --variant Release
yarn android --variant Release
- npm
- yarn
npm run ios -- --configuration Release
yarn ios --configuration Release
6. Configure Your Deployment Key
Paste the Staging Deployment Key you copied in the previous step to generate a QR code:
7. Test an Over-the-Air Update
Now let's publish an update to test the OTA functionality:
- Make a change in the src/app/playground.tsx file, in the config object at the top of the file.
- Release the update using Turbopush CLI:
- npm
- yarn
npx turbopush release-expo <app-slug> android 1.0.0 -d Staging --mandatory
yarn turbopush release-expo <app-slug> android 1.0.0 -d Staging --mandatory
- Click in the "sync" button in the initial screen.
- Watch the update download and install automatically!
- Click in the "Playground" button in the initial screen to see the change you made.
- That's it! You've successfully published an update to your app and tested it over-the-air. 🎉
Next Steps
Troubleshooting
Updates not appearing?
- Check that the update's target binary version matches your app version
- Verify your deployment keys are correct
- Check the logs in screen to see if there are any errors.