Expo Docs MCP Server

--- title: Automating EAS CLI commands description: Learn how to automate sequences of EAS CLI commands with EAS Workflows. --- If you're using EAS CLI to build, submit, and update your app, you can automate sequences of commands with EAS Workflows. EAS Workflows can build, submit, and update your app, while also running other jobs like Maestro tests, unit tests, custom scripts, and more. Below you'll find how to set up your project to use EAS Workflows, followed by common examples of EAS CLI commands and how you can run them using EAS Workflows. ## Configure your project EAS Workflows optionally supports a GitHub repository that's linked to your EAS project to run. This guide assumes a GitHub repository is linked, and shows how to trigger workflows when pushing to specific branches on GitHub. You can link a GitHub repo to your EAS project with the following steps: - Navigate to your project's [GitHub settings](https://expo.dev/accounts/%5Baccount%5D/projects/%5BprojectName%5D/github). - Follow the UI to install the GitHub app. - Select the GitHub repository that matches the Expo project and connect it. ## Creating builds You can make a build of your project using EAS CLI with the `eas build` command. To make an iOS build with the `production` build profile, you could run the following EAS CLI command: To write this command as a workflow, create a workflow file named **.eas/workflows/build-ios-production.yml** at the root of your project. Inside **build-ios-production.yml**, you can use the following workflow to kick off a job that creates an iOS build with the `production` build profile. ```yaml .eas/workflows/build-ios-production.yml name: iOS production build on: push: branches: ['main'] jobs: build_ios: name: Build iOS type: build params: platform: ios profile: production ``` Once you have this workflow file, you can kick it off by pushing a commit to the `main` branch, or by running the following EAS CLI command: You can provide parameters to make Android builds or use other build profiles. Learn more about build job parameters with the [build job documentation](/eas/workflows/syntax/#build). ## Submitting builds You can submit your app to the app stores using EAS CLI with the `eas submit` command. To submit an iOS app, you could run the following EAS CLI command: To write this command as a workflow, create a workflow file named **.eas/workflows/submit-ios.yml** at the root of your project. Inside **submit-ios.yml**, you can use the following workflow to kick off a job that submits an iOS app. ```yaml .eas/workflows/submit-ios.yml name: Submit iOS app on: push: branches: ['main'] jobs: submit_ios: name: Submit iOS type: submit params: platform: ios ``` Once you have this workflow file, you can kick it off by pushing a commit to the `main` branch, or by running the following EAS CLI command: You can provide parameters to submit other platforms or use other submit profiles. Learn more about submit job parameters with the [submit job documentation](/eas/workflows/syntax/#submit). ## Publishing updates You can update your app using EAS CLI with the `eas update` command. To update your app, you could run the following EAS CLI command: To write this command as a workflow, create a workflow file named **.eas/workflows/publish-update.yml** at the root of your project. Inside **publish-update.yml**, you can use the following workflow to kick off a job that sends and over-the-air update. ```yaml .eas/workflows/publish-update.yml name: Publish update on: push: branches: ['*'] jobs: update: name: Update type: update params: branch: ${{ github.ref_name || 'test'}} ``` Once you have this workflow file, you can kick it off by pushing a commit to any branch, or by running the following EAS CLI command: You can provide parameters to update specific branches or channels, and configure the update's message. Learn more about update job parameters with the [update job documentation](/eas/workflows/syntax/#update). ## Next step Workflows are a powerful way to automate your development and release processes. Learn how to create development builds, publish preview updates, and create production builds with the workflows examples guide: