Runway Documentation
  • About Runway
  • 🚀Getting started
    • Adding apps
    • Setting up your integrations
      • Branching strategies
      • Builds and branches
      • Pattern strings / tokens
    • Preparing your first release
    • Setting up your team
  • 🎛️Using Runway
    • Navigating Runway
    • Build Distro
      • Quickstart
      • Uploading builds for distribution
      • Build Distro buckets
      • Sharing builds
      • Installing builds
      • Signing and provisioning cheat sheet
    • App overview
    • Releases
      • Release overview
      • Feature flags
      • Kickoff
      • Feature readiness
      • Translations
      • Release candidate
      • Regression testing
      • Beta testing
      • Screenshots
      • Metadata
      • Approvals
      • App submission
      • App store review
      • Release
    • Release schedule
    • Rollout
    • Hotfixes
    • Rollbacks
    • Checklists
    • Build matching
    • App settings
      • General settings
      • Team settings
      • Release pilot rotation
      • Integrations settings
      • Profiles and devices
      • Signing keys
      • Health metrics settings
      • Automations settings
      • Notifications settings
      • Schedule settings
      • Beta testing settings
      • Metadata settings
      • Release defaults
      • Checklists settings
      • Custom strings settings
    • Organization overview
    • Organization settings
      • Team
      • SSO/SAML
    • User settings
    • Over-the-air (OTA) releases
  • ⚙️Integrations
    • Integrations overview
    • Version control
      • Azure Repos
      • Bitbucket
      • GitHub
      • GitLab
    • Project management
      • Asana
      • Azure Boards
      • GitHub Issues
      • Jira
      • Linear
      • Pivotal Tracker
      • Monday.com
      • Shortcut
    • CI/CD
      • App Center Build
      • Azure Pipelines
      • Bitbucket Pipelines
      • Bitrise
      • Buildkite
      • CircleCI
      • Codemagic
      • GitHub Actions
      • GitLab CI
      • Jenkins
      • TravisCI
      • Xcode Cloud
    • Regression testing
      • TestRail
      • Xray
    • Beta testing
      • Google Play testing tracks
      • TestFlight
      • App Center
      • Firebase App Distribution
    • App stores
      • App Store Connect
      • Google Play Console
      • Amazon Appstore
      • Huawei AppGallery
      • Samsung Galaxy Store
    • Notifications
      • Microsoft Teams
      • Slack
    • Stability monitoring
      • BugSnag
      • Datadog
      • Embrace
      • Firebase Crashlytics
      • New Relic
      • Sentry
      • Dynatrace
    • Observability & analytics
      • Amplitude
      • Datadog
      • Google Analytics
      • Mixpanel
      • New Relic
      • Custom observability & analytics
    • Feature flagging
      • Optimizely
      • LaunchDarkly
    • Scheduling
      • Opsgenie
      • PagerDuty
    • Translations
      • Crowdin
      • Lokalise
    • Calendar
      • Google Calendar
  • ⚡Automations
    • Automations overview
    • Types of automations
  • 🔔Notifications
    • Notifications overview
    • Types of notifications
  • 🪝Webhooks
    • Outgoing webhooks
  • 📡REST API
    • Overview
    • Reference Docs
    • Markdown Badge API
    • App configuration files
  • 🛠️Quickstart CI/CD
    • Quickstart CI/CD overview
    • Getting started
  • Support
    • Contact us
Powered by GitBook
On this page
  • Version history sidebar
  • Link to app settings
  • Prepare a new release
  • Release list

Was this helpful?

  1. Using Runway

App overview

PreviousSigning and provisioning cheat sheetNextReleases

Last updated 1 month ago

Was this helpful?

App overview is a dedicated view to understand at a glance the release history and current activity related to a particular app or app platform.

Version history sidebar

A timeline with all historical, current, and upcoming versions of your app appears to the left. At the top, you'll see the name of the selected app and platform.

Link to app settings

You can navigate to App Settings by clicking the gear icon (⚙️) at the top.

Prepare a new release

Click the Prepare new dropdown to choose to either prepare a new release, or create a hotfix release.

  • Release version (required) - Enter the planned version number of your next release. Runway will determine whether it's a major, minor, or point release based on .

  • Release pilot - Choose a specific team member to act as release pilot for this release. If no selection is made, Runway will automatically assign a release pilot from a rotation of team members who are for this app.

  • Target kickoff date - Specify a target date for when you plan to kick off this release.

    • For release branch teams, Runway considers a release kicked off when a release branch is detected or .

    • For static branch teams, Runway considers a release kicked off when code is detected past the last release tag, or when from your development branch to your release branch.

  • Target submit date - Specify a target date for when you plan to submit this release to the app store for review.

  • Target release date - Specify a target date for when you plan to release this app update to end users.

Hotfix release

If you choose to prepare a hotfix release, Runway will:

  • Predict a hotfix version and attempt to warn on any issues regarding intended version

  • (Optional) Immediately create a release branch from the previous release tag

  • (Optional) Bump version on release branch

  • Your cadence/scheduled automations will not be applied.

You can set an option on checklist items, approvals items, or regression testing items in Runway that will have them apply only to hotfix releases, or only to non-hotfix releases.

Release list

Here you'll see a list of all releases, including:

  • Completed - Releases that have been released from the app store.

    • The initial release date is shown alongside completed releases (for phased releases, the date shown is Day 1 of the phased release)

    • If the most recent Completed release is a Phased release in progress, you'll see the Phased percentage in place of the release date.

    • A half-filled circle represents a phased release that never reached 100%.

Releases are considered completed under the following conditions:

  • iOS: Manually or automatically released (or Day 1 of a phased rollout)

  • Android: When updated is submitted for review

    • Runway doesn't have visibility into status past this point due to API limitations.

  • Next release - The 'active' release in progress, intended to be the next version released to end users.

  • Upcoming - Future releases planned past the next release.

If you have related enabled, Runway will attempt to perform these automations on the target dates specified here.

If you have an active , your normal release schedule will remain unaffected on other releases. If the hotfix isn't released prior to your next kickoff, Runway will push back your future releases' target dates to compensate.

An alert icon ( ) represents a release that has not yet been tagged.

Click into any release to see the dedicated for that version.

🎛️
⚠️
release schedule cadence
Release view
semantic versioning rules
eligible to be release pilots
created by Runway
Runway promotes code
release cycle automations