ExpoDeploy
Back to Documentation

GitHub Integration

Connect your GitHub repositories to enable automatic builds on every code push. ExpoDeploy integrates seamlessly with GitHub using OAuth and webhooks.

Connecting a Repository

During the onboarding process, ExpoDeploy displays all GitHub repositories you have access to. The integration process is straightforward:

  1. 1Authenticate with GitHub using OAuth when you sign in to ExpoDeploy
  2. 2Select your repository from the list during project creation
  3. 3ExpoDeploy automatically creates and configures webhooks for your repository
  4. 4Configure which branches trigger builds in your project settings

Webhook Configuration

When you connect a repository, ExpoDeploy automatically creates a GitHub webhook that listens for push events. This webhook:

  • • Monitors all push events to your repository
  • • Filters pushes based on your configured branch rules
  • • Triggers builds automatically when matching branches receive commits
  • • Includes commit metadata (author, message, SHA) in build information

Webhooks are managed automatically - you don't need to configure anything manually. If you disconnect a repository, the webhook is automatically removed.

Security & Permissions

ExpoDeploy requests minimal GitHub permissions to function:

  • Repository Access: Read-only access to detect code pushes and read repository metadata
  • Webhook Management: Ability to create and manage webhooks for automatic build triggers
  • Commit Information: Read commit messages, authors, and SHA hashes for build tracking

ExpoDeploy never writes to your repositories or accesses your source code. We only read metadata and commit information necessary for triggering builds.