chore: map environments

Author: Petr Konecny

.github/actions/map-environment/action.yml

@@ -0,0 +1,32 @@
+name: Map Environment
+description: 'Maps environment names to Expo environment names'
+inputs:
+  environment:
+    required: true
+    description: 'The environment to map (dev, staging) or pass through (development, preview, production)'
+outputs:
+  expo_environment:
+    description: 'The mapped Expo environment name (development, preview, production)'
+    value: ${{ steps.map-env.outputs.expo_environment }}
+runs:
+  using: composite
+  steps:
+    - name: Map environment to Expo environment
+      id: map-env
+      shell: bash
+      run: |
+        case "${{ inputs.environment }}" in
+          "dev")
+            echo "expo_environment=development" >> $GITHUB_OUTPUT
+            ;;
+          "staging")
+            echo "expo_environment=preview" >> $GITHUB_OUTPUT
+            ;;
+          "development"|"preview"|"production")
+            echo "expo_environment=${{ inputs.environment }}" >> $GITHUB_OUTPUT
+            ;;
+          *)
+            echo "Unknown environment: ${{ inputs.environment }}"
+            exit 1
+            ;;
+        esac

.github/actions/ota-update/action.yml

@@ -7,15 +7,26 @@ inputs:
   version:
     required: true
     description: 'The version number'
+  environment:
+    required: true
+    description: 'The environment to update'
 runs:
   using: composite
   steps:
     - name: Set environment variables
       shell: bash
       run: |
         echo "EXPO_PUBLIC_APP_VERSION=${{ inputs.version }}" >> $GITHUB_ENV
+
+    - name: Map environment
+      uses: ./.github/actions/map-environment
+      id: map-env
+      with:
+        environment: ${{ inputs.environment }}
+
     - name: Perform OTA Update
       shell: bash
       run: |
         eas update --channel ${{ inputs.channel }} \
+          --environment ${{ steps.map-env.outputs.expo_environment }} \
           --message "Update ${{ inputs.channel }} to ${{ inputs.version }}"

.gitignore

@@ -15,6 +15,7 @@ web-build/
 
 # env
 .env
+.env.local
 
 # native folers
 android/

README.md

@@ -193,22 +193,30 @@ To replicate Figma design consistently on majority of mobile screen sizes, we sh
 
 ## Adding new `ENV` variables:
 
-**Format**:
+We highly recommend using EAS to manage environments.
 
-- All variables must use the `EXPO_PUBLIC` prefix! e.g., `EXPO_PUBLIC_API_URL`
+We map our environment names to the Expo environments names.
 
-**Github**:
+```
+"dev": "development",
+"staging": "preview",
+"production": "production"
+```
 
-- There are two options for adding/managing env credentials:
+Inside Github Actions we use an action to map the environments automatically.
+To add new environment variable:
 
-1. **Variables by a specific env**:
+- Either add it through the Expo dashboard
+- Or through eas cli:
 
-> Settings -> Environments -> Select/add Env (dev, staging, production) -> Add a new variable
+```
+eas env:create [EXPO_ENVIRONMENT] --name <name> --value <value>
+```
 
-2. **Shared variables**:
+> ⚠️ All variables must use the `EXPO_PUBLIC` prefix! e.g., `EXPO_PUBLIC_API_URL`
 
-> Settings -> Secrets and Variables -> Actions -> Select Variables tab -> New repository variable
+You can also pull variables from EAS to your local `.env` file:
 
 ```
-
+eas env:pull [EXPO_ENVIRONMENT]
 ```

eas.json

@@ -1,20 +1,19 @@
 {
   "cli": {
-    "version": ">= 3.13.3"
+    "version": ">= 3.13.3",
+    "appVersionSource": "remote"
   },
   "build": {
     "base": {
       "ios": {
         "resourceClass": "medium"
       }
     },
-    "cli": {
-      "appVersionSource": "remote"
-    },
     "dev": {
       "extends": "base",
       "developmentClient": true,
       "distribution": "internal",
+      "environment": "development",
       "android": {
         "buildType": "apk"
       },
@@ -25,6 +24,7 @@
     },
     "dev-sim": {
       "extends": "dev",
+      "environment": "development",
       "ios": {
         "simulator": true
       }
@@ -34,6 +34,7 @@
       "distribution": "store",
       "channel": "staging",
       "autoIncrement": true,
+      "environment": "preview",
       "env": {
         "EXPO_PUBLIC_APP_ENV": "staging"
       }
@@ -42,6 +43,7 @@
       "extends": "base",
       "distribution": "store",
       "channel": "production",
+      "environment": "production",
       "env": {
         "EXPO_PUBLIC_APP_ENV": "production"
       }