Back to Documentation

Installation & Setup

Get ExpoDeploy configured in minutes. Follow these steps to automate your mobile app build and deployment pipeline.

1

Sign In with GitHub

Authenticate using your GitHub account

ExpoDeploy uses GitHub OAuth for secure authentication. Click "Sign In" on the homepage to authorize ExpoDeploy. We only request read access to your repositories to detect pushes and manage webhooks.

2

Create or Select a Workspace

Organize your projects in workspaces

Workspaces help you organize projects by team or product. Create a new workspace or select an existing one. You can be a member of multiple workspaces and switch between them easily.

3

Connect App Store Accounts

Link App Store Connect and Google Play Console

Connect your App Store Connect account using an API key, or your Google Play Console using a Service Account JSON. You can connect both platforms or start with just one. These credentials are encrypted and stored securely.

4

Select Your App

Choose the app from your connected stores

ExpoDeploy fetches your existing apps from App Store Connect and Google Play Console. Select the app you want to automate deployments for. If you don't see your app, make sure it's already created in the respective store console.

5

Link Your Repository

Connect your GitHub repository

Select the GitHub repository containing your Expo or React Native project. ExpoDeploy will automatically set up webhooks to detect code pushes. Your repository must contain an app.json or app.config.js file.

6

Configure Branch Rules

Set up automatic build triggers

Choose which branches trigger builds automatically. For example, configure "main" for production builds and "develop" for staging. You can add multiple branches and customize build profiles per branch.

Before You Begin

Ensure you have the following ready before starting:

  • GitHub Account - With push access to your repository
  • Expo Account - Free tier is sufficient for getting started
  • Expo or React Native Project - Already pushed to GitHub with app.json or app.config.js
  • Store Accounts (Optional) - App Store Connect API key or Google Play Service Account for automatic deployments