1# EAS Workflows
2 
3Automate builds, submissions, and deployments with EAS Workflows.
4 
5## Web Deployment
6 
7Deploy web apps on push to main:
8 
9`.eas/workflows/deploy.yml`
10 
11```yaml
12name: Deploy
13 
14on:
15  push:
16    branches:
17      - main
18 
19# https://docs.expo.dev/eas/workflows/syntax/#deploy
20jobs:
21  deploy_web:
22    type: deploy
23    params:
24      prod: true
25```
26 
27## PR Previews
28 
29### Web PR Previews
30 
31```yaml
32name: Web PR Preview
33 
34on:
35  pull_request:
36    types: [opened, synchronize]
37 
38jobs:
39  preview:
40    type: deploy
41    params:
42      prod: false
43```
44 
45### Native PR Previews with EAS Updates
46 
47Deploy OTA updates for pull requests:
48 
49```yaml
50name: PR Preview
51 
52on:
53  pull_request:
54    types: [opened, synchronize]
55 
56jobs:
57  publish:
58    type: update
59    params:
60      branch: "pr-${{ github.event.pull_request.number }}"
61      message: "PR #${{ github.event.pull_request.number }}"
62```
63 
64## Production Release
65 
66Complete release workflow for both platforms:
67 
68```yaml
69name: Release
70 
71on:
72  push:
73    tags: ['v*']
74 
75jobs:
76  build-ios:
77    type: build
78    params:
79      platform: ios
80      profile: production
81 
82  build-android:
83    type: build
84    params:
85      platform: android
86      profile: production
87 
88  submit-ios:
89    type: submit
90    needs: [build-ios]
91    params:
92      platform: ios
93      profile: production
94 
95  submit-android:
96    type: submit
97    needs: [build-android]
98    params:
99      platform: android
100      profile: production
101```
102 
103## Build on Push
104 
105Trigger builds when pushing to specific branches:
106 
107```yaml
108name: Build
109 
110on:
111  push:
112    branches:
113      - main
114      - release/*
115 
116jobs:
117  build:
118    type: build
119    params:
120      platform: all
121      profile: production
122```
123 
124## Conditional Jobs
125 
126Run jobs based on conditions:
127 
128```yaml
129name: Conditional Release
130 
131on:
132  push:
133    branches: [main]
134 
135jobs:
136  check-changes:
137    type: run
138    params:
139      command: |
140        if git diff --name-only HEAD~1 | grep -q "^src/"; then
141          echo "has_changes=true" >> $GITHUB_OUTPUT
142        fi
143 
144  build:
145    type: build
146    needs: [check-changes]
147    if: needs.check-changes.outputs.has_changes == 'true'
148    params:
149      platform: all
150      profile: production
151```
152 
153## Workflow Syntax Reference
154 
155### Triggers
156 
157```yaml
158on:
159  push:
160    branches: [main, develop]
161    tags: ['v*']
162  pull_request:
163    types: [opened, synchronize, reopened]
164  schedule:
165    - cron: '0 0 * * *'  # Daily at midnight
166  workflow_dispatch:  # Manual trigger
167```
168 
169### Job Types
170 
171| Type | Purpose |
172|------|---------|
173| `build` | Create app builds |
174| `submit` | Submit to app stores |
175| `update` | Publish OTA updates |
176| `deploy` | Deploy web apps |
177| `run` | Execute custom commands |
178 
179### Job Dependencies
180 
181```yaml
182jobs:
183  first:
184    type: build
185    params:
186      platform: ios
187 
188  second:
189    type: submit
190    needs: [first]  # Runs after 'first' completes
191    params:
192      platform: ios
193```
194 
195## Tips
196 
197- Use `workflow_dispatch` for manual production releases
198- Combine PR previews with GitHub status checks
199- Use tags for versioned releases
200- Keep sensitive values in EAS Secrets, not workflow files
201