Get started with EAS Workflows

Learn how to use EAS Workflows to automate your development and release processes.

EAS Workflows are currently in preview. We may introduce breaking changes in the coming weeks. Got feedback? Send us an email at workflows@expo.dev.

Builds, submissions, updates, and more are all a part of delivering your app to users. EAS Workflows consist of a sequence of jobs, which help you and your team get things done. With workflows, you can build your project, run end-to-end tests, submit that build to the app stores, and then run custom scripts after the submission is complete. Since each job can have prerequisites and conditionals, you can automate your and your team's release process.

Set up your project

If you haven't already, you'll need to create a project and sync it with EAS:

Then, create a directory named .eas/workflows at the root of your project with a .yaml file inside of it. For example: .eas/workflows/hello-world.yaml.

Write a workflow

Each workflow consists of three top-level elements:

• name: defines the name of the workflow. For example: "Hello World"
• on: defines when this workflow should be triggered. For example, when pushing a new commit to a GitHub branch.
• jobs: a sequence of jobs which can depend on and pass data between each other. For example: a job that runs a unit test followed by a job that builds your project into an app.

Here's an example of a workflow that prints "Hello, world":

name: Hello World

on:
  push:
    branches: ['*']

jobs:
  Hello World:
    steps:
      - run: echo "Hello, World"

Here's another example that creates and submits an iOS build of a project on every push to every branch. This is similar to running eas build --platform ios --profile production --auto-submit:

name: Release iOS app

on:
  push:
    branches: ['*']

jobs:
  build:
    type: build
    params:
      platform: ios
      profile: production
  submit:
    needs: [build]
    type: submit
    params:
      build_id: ${{ needs.build.outputs.build_id }}

Configure your project

To enable workflows to run on events from GitHub, you'll need to install Expo's GitHub app and connect it to your project:

• Navigate to your project's GitHub settings
• Follow the UI to install the GitHub app. Then search for the GitHub repository that matches the Expo project and connect it.

Run your workflow

Once you have a workflow file and your project is connected to Expo's GitHub app, you can trigger your workflow by pushing a commit to your GitHub repository. For the workflow to run, you'll need to make sure the trigger (defined with on) you defined in your workflow is met.

Alternatively, you can trigger a workflow manually by running the following command:

Once you do, you can see your workflow running on your project's workflows page.

Building blocks

Learn more about the building blocks of workflows: