Skip to main content
A build is a container for your app versions. Each build can have multiple versions (releases). Builds page overview

Key Concepts

  • Build: Named container (e.g., “Android Test App”)
  • Version: Specific release (e.g., “1.0.0”)
  • Platform: iOS or Android
  • Package Name: Unique identifier (e.g., com.company.app)

The Builds Page

Top metrics: Total Builds, iOS Builds, Android Builds Left sidebar: All builds organized by platform
  • 🍎 iOS builds
  • 🤖 Android builds
Click any build to view its versions.

Creating a Build

Create build dialog
  1. Click Create build
  2. Fill in:
    • Name (required)
    • Platform (required): iOS or Android
    • Description (optional)
Platform dropdown Filled build creation form
  1. Click Continue

Version Management

Versions table shows:
  • Version Name (e.g., 1.0.0) with “Latest” badge
  • Created on date
  • Package name
  • Branch & commits (from CI/CD)

Adding a Version

Upload new version dialog Option 1: Upload manually
  1. Select build from sidebar
  2. Click Add new version
  3. Enter version number
  4. Upload your build file:
    • Android: .apk file (or .zip containing an .apk)
    • iOS: Simulator .app bundle (see note below)
Option 2: Import from Expo Builds page with Upload from Expo button
  1. Select build from sidebar
  2. Click Upload from Expo button
  3. Select your Expo project and fetch builds
  4. Choose a build and click Import Build
Full Expo integration guide → iOS Builds Note: You can upload a zipped .app file via the file picker, or drag and drop an unzipped .app folder directly. The file picker cannot select folders, so use drag-and-drop for unzipped .app bundles.

Version Actions

Menu (⋮) options:
  • Download: Get build file
  • Delete: Remove version (permanent)

Build Details

Switching builds: Click any build in sidebar (highlighted in purple) Latest version: Marked with “Latest” badge Search: Filter builds by name or version

Next Steps