Skip to content

Colota - Android GPS Location tracker

chore: remove Maestro screenshot generation in favor of manual screenshots

Max Dietricha23d0bb731ce
diff --git a/.github/workflows/screenshots.yml b/.github/workflows/screenshots.yml
deleted file mode 100644
index 2ef81bcb..00000000
--- a/.github/workflows/screenshots.yml
+++ /dev/null
@@ -1,91 +0,0 @@
-name: Generate Screenshots
-
-on:
- workflow_dispatch:
-
-permissions:
- contents: write
-
-jobs:
- screenshots:
- name: Capture App Screenshots
- runs-on: macos-14
-
- steps:
- - name: Checkout code
- uses: actions/checkout@v4
-
- - name: Setup Node.js
- uses: actions/setup-node@v4
- with:
- node-version: '20'
- cache: 'npm'
-
- - name: Setup Java
- uses: actions/setup-java@v4
- with:
- distribution: 'temurin'
- java-version: '17'
- cache: 'gradle'
-
- - name: Install dependencies
- run: npm ci
-
- - name: Build shared package
- run: npm run build -w @colota/shared
-
- - name: Create gradle.properties
- run: |
- cat <<EOF > apps/mobile/android/gradle.properties
- org.gradle.jvmargs=-Xmx4096m -XX:MaxMetaspaceSize=512m
- android.useAndroidX=true
- hermesEnabled=true
- newArchEnabled=true
- EOF
-
- - name: Build GMS Debug APK
- run: |
- cd apps/mobile/android
- chmod +x gradlew
- ./gradlew assembleGmsDebug --no-daemon \
- -Dorg.gradle.jvmargs="-Xmx4096m -XX:MaxMetaspaceSize=512m"
-
- - name: Install Maestro CLI
- run: |
- curl -Ls "https://get.maestro.mobile.dev" | bash
- echo "$HOME/.maestro/bin" >> $GITHUB_PATH
-
- - name: Setup Android Emulator
- uses: reactivecircus/android-emulator-runner@v2
- with:
- api-level: 34
- arch: arm64-v8a
- profile: pixel_6
- force-avd-creation: false
- emulator-options: -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim
- emulator-boot-timeout: 600
- disable-animations: true
- script: |
- adb install $(find apps/mobile/android/app/build/outputs/apk/gms/debug -name "*arm64*debug.apk" | head -1)
-
- maestro test --output screenshots/mobile/original/ .maestro/screenshots/
-
- python3 scripts/sync-screenshots.py
-
- - name: Upload screenshots
- uses: actions/upload-artifact@v4
- with:
- name: screenshots
- path: screenshots/mobile/original/
-
- - name: Commit updated screenshots
- run: |
- git config user.name "github-actions[bot]"
- git config user.email "github-actions[bot]@users.noreply.github.com"
- git add screenshots/ apps/docs/static/img/screenshots/ apps/mobile/android/app/fastlane/metadata/android/en-US/images/phoneScreenshots/
- if git diff --cached --quiet; then
- echo "No screenshot changes to commit"
- else
- git commit -m "Update screenshots via CI"
- git push
- fi
diff --git a/.maestro/screenshots/01-dashboard.yaml b/.maestro/screenshots/01-dashboard.yaml
deleted file mode 100644
index 251be58c..00000000
--- a/.maestro/screenshots/01-dashboard.yaml
+++ /dev/null
@@ -1,6 +0,0 @@
-appId: com.colota
----
-- launchApp:
- clearState: true
-- waitForAnimationToEnd
-- takeScreenshot: Dashboard
diff --git a/.maestro/screenshots/02-settings.yaml b/.maestro/screenshots/02-settings.yaml
deleted file mode 100644
index 4682b895..00000000
--- a/.maestro/screenshots/02-settings.yaml
+++ /dev/null
@@ -1,7 +0,0 @@
-appId: com.colota
----
-- launchApp
-- waitForAnimationToEnd
-- tapOn: "Settings"
-- waitForAnimationToEnd
-- takeScreenshot: Settings
diff --git a/.maestro/screenshots/03-authentication.yaml b/.maestro/screenshots/03-authentication.yaml
deleted file mode 100644
index 66529652..00000000
--- a/.maestro/screenshots/03-authentication.yaml
+++ /dev/null
@@ -1,12 +0,0 @@
-appId: com.colota
----
-- launchApp
-- waitForAnimationToEnd
-- tapOn: "Settings"
-- waitForAnimationToEnd
-- scrollUntilVisible:
- element: "Authentication & Headers"
- direction: DOWN
-- tapOn: "Authentication & Headers"
-- waitForAnimationToEnd
-- takeScreenshot: Authentication
diff --git a/.maestro/screenshots/04-profile-editor.yaml b/.maestro/screenshots/04-profile-editor.yaml
deleted file mode 100644
index 9ef37f65..00000000
--- a/.maestro/screenshots/04-profile-editor.yaml
+++ /dev/null
@@ -1,14 +0,0 @@
-appId: com.colota
----
-- launchApp
-- waitForAnimationToEnd
-- tapOn: "Settings"
-- waitForAnimationToEnd
-- scrollUntilVisible:
- element: "Tracking Profiles"
- direction: DOWN
-- tapOn: "Tracking Profiles"
-- waitForAnimationToEnd
-- tapOn: "Create Profile"
-- waitForAnimationToEnd
-- takeScreenshot: TrackingProfiles
diff --git a/.maestro/screenshots/05-data-management.yaml b/.maestro/screenshots/05-data-management.yaml
deleted file mode 100644
index c9e5a960..00000000
--- a/.maestro/screenshots/05-data-management.yaml
+++ /dev/null
@@ -1,12 +0,0 @@
-appId: com.colota
----
-- launchApp
-- waitForAnimationToEnd
-- tapOn: "Settings"
-- waitForAnimationToEnd
-- scrollUntilVisible:
- element: "Data Management"
- direction: DOWN
-- tapOn: "Data Management"
-- waitForAnimationToEnd
-- takeScreenshot: DataManagement
diff --git a/.maestro/screenshots/06-api-field-mapping.yaml b/.maestro/screenshots/06-api-field-mapping.yaml
deleted file mode 100644
index 5a036960..00000000
--- a/.maestro/screenshots/06-api-field-mapping.yaml
+++ /dev/null
@@ -1,12 +0,0 @@
-appId: com.colota
----
-- launchApp
-- waitForAnimationToEnd
-- tapOn: "Settings"
-- waitForAnimationToEnd
-- scrollUntilVisible:
- element: "API Field Mapping"
- direction: DOWN
-- tapOn: "API Field Mapping"
-- waitForAnimationToEnd
-- takeScreenshot: ApiFieldMapping
diff --git a/.maestro/screenshots/07-export-data.yaml b/.maestro/screenshots/07-export-data.yaml
deleted file mode 100644
index 6580d7e9..00000000
--- a/.maestro/screenshots/07-export-data.yaml
+++ /dev/null
@@ -1,7 +0,0 @@
-appId: com.colota
----
-- launchApp
-- waitForAnimationToEnd
-- tapOn: "Export"
-- waitForAnimationToEnd
-- takeScreenshot: ExportData
diff --git a/.maestro/screenshots/08-dark-mode.yaml b/.maestro/screenshots/08-dark-mode.yaml
deleted file mode 100644
index 9e04bfe3..00000000
--- a/.maestro/screenshots/08-dark-mode.yaml
+++ /dev/null
@@ -1,13 +0,0 @@
-appId: com.colota
----
-- launchApp
-- waitForAnimationToEnd
-- tapOn: "Settings"
-- waitForAnimationToEnd
-- scrollUntilVisible:
- element: "Dark Mode"
- direction: DOWN
-- tapOn: "Dark Mode"
-- waitForAnimationToEnd
-- takeScreenshot: DarkMode
-- tapOn: "Dark Mode"
diff --git a/apps/docs/docs/development/local-setup.md b/apps/docs/docs/development/local-setup.md
index 0c54d951..c7ef9fa7 100644
--- a/apps/docs/docs/development/local-setup.md
+++ b/apps/docs/docs/development/local-setup.md
@@ -105,8 +105,6 @@ npm run build
```
colota/
-├── .maestro/
-│ └── screenshots/ # Maestro UI flows for screenshot capture
├── apps/
│ ├── mobile/
│ │ ├── android/ # Android native project
@@ -216,11 +214,13 @@ npm run version:bump 1.2.0
This updates `version` in all `package.json` files, `versionName` in `build.gradle`, and auto-increments `versionCode`.
-### Generating Screenshots
+### Syncing Screenshots
-App screenshots live in `screenshots/mobile/original/` (single source of truth) and are synced to the docs site and Fastlane store metadata.
+App screenshots live in `screenshots/mobile/original/` (single source of truth). After adding or updating screenshots there, sync them to the docs site and Fastlane store metadata:
-**Capture**: Trigger the "Generate Screenshots" workflow manually from GitHub Actions. It starts an Android emulator, runs [Maestro](https://maestro.mobile.dev) flows from `.maestro/screenshots/`, and commits the updated screenshots.
+```bash
+npm run sync:screenshots
+```
### Adding Documentation