ref: Migrate from Emerge Tools to Sentry

Replace Emerge's suite of products with Sentry for size analysis, snapshot
testing, and distribution across both platforms. This removes the Emerge
Gradle plugin, fastlane plugin, SDK dependencies, snapshot maven repos, and
emerge_config.yaml in favor of their Sentry equivalents.

Rename the CI workflows from ios/android_emerge_* to *_sentry_* and drop the
now-redundant ios_emerge_upload_snapshots workflow. Update the README, app
metadata, and "built by" UI to reference Sentry instead of Emerge.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: cameroncooke

.github/workflows/android_beta_build.yml

@@ -1,4 +1,4 @@
-name: Android Beta Build
+name: Sentry Android Build Distribution
 
 on:
   push:
@@ -32,13 +32,12 @@ jobs:
           echo $ENCODED_KEYSTORE > keystore_base64.txt
           base64 -d keystore_base64.txt > ${{ runner.temp }}/keystore.jks
 
-      - name: Build Beta APK
+      - name: Build beta APK and upload to Sentry Build Distribution
         env:
           DECODED_KEYSTORE_PATH: ${{ runner.temp }}/keystore.jks
           RELEASE_KEY_ALIAS: ${{ secrets.ANDROID_RELEASE_KEY_ALIAS }}
           RELEASE_KEY_PASSWORD: ${{ secrets.ANDROID_RELEASE_KEY_PASSWORD }}
           RELEASE_STORE_PASSWORD: ${{ secrets.ANDROID_RELEASE_STORE_PASSWORD }}
-          EMERGE_API_TOKEN: ${{ secrets.EMERGE_API_KEY }}
           SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_SENTRY_AUTH_TOKEN }}
           SENTRY_DISTRIBUTION_AUTH_TOKEN: ${{ secrets.SENTRY_DISTRIBUTION_AUTH_TOKEN }}
         run: ./gradlew :app:assembleBeta

.github/workflows/android_release_build.yml

@@ -42,7 +42,6 @@ jobs:
           RELEASE_KEY_ALIAS: ${{ secrets.ANDROID_RELEASE_KEY_ALIAS }}
           RELEASE_KEY_PASSWORD: ${{ secrets.ANDROID_RELEASE_KEY_PASSWORD }}
           RELEASE_STORE_PASSWORD: ${{ secrets.ANDROID_RELEASE_STORE_PASSWORD }}
-          EMERGE_API_TOKEN: ${{ secrets.EMERGE_API_KEY }}
           SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_SENTRY_AUTH_TOKEN }}
         run: ./gradlew :app:bundlePlayStoreRelease
 

…thub/workflows/android_emerge_upload.yml …rkflows/android_sentry_size_analysis.yml.github/workflows/android_emerge_upload.yml renamed to .github/workflows/android_sentry_size_analysis.yml .github/workflows/android_emerge_upload.yml renamed to .github/workflows/android_sentry_size_analysis.yml

@@ -1,4 +1,4 @@
-name: Emerge + Sentry Android Size & Distribution
+name: Sentry Android Size Analysis
 
 on:
   push:
@@ -24,8 +24,7 @@ jobs:
           distribution: "temurin"
       - name: Setup Gradle build action
         uses: gradle/actions/setup-gradle@v6
-      - name: Emerge analysis
-        run: ./gradlew :app:bundleRelease :app:emergeUploadReleaseAab
+      - name: Sentry size analysis
+        run: ./gradlew :app:bundleRelease
         env:
-          EMERGE_API_TOKEN: ${{ secrets.EMERGE_API_KEY }}
           SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_SENTRY_AUTH_TOKEN }}

…b/workflows/android_emerge_snapshots.yml …lows/android_sentry_upload_snapshots.yml.github/workflows/android_emerge_snapshots.yml renamed to .github/workflows/android_sentry_upload_snapshots.yml .github/workflows/android_emerge_snapshots.yml renamed to .github/workflows/android_sentry_upload_snapshots.yml

@@ -1,4 +1,4 @@
-name: Generate Android Snapshots
+name: Sentry Android Snapshots Upload
 
 on:
   push:
@@ -29,29 +29,7 @@ jobs:
       - name: Setup Gradle build action
         uses: gradle/actions/setup-gradle@v6
 
-      - name: Ruby setup
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: 3.3.10
-          bundler-cache: true
-
-      - name: Setup gems
-        run: gem install emerge
-
-      - name: Generate Paparazzi snapshots
+      - name: Upload Sentry snapshots
         run: ./gradlew :app:sentryUploadSnapshotsDebug
         env:
           SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_SENTRY_AUTH_TOKEN }}
-
-      - name: Upload snapshots
-        env:
-          EMERGE_API_TOKEN: ${{ secrets.EMERGE_API_KEY }}
-        run: |
-          emerge upload snapshots \
-            --name "Hacker News" \
-            --id "com.emergetools.hackernews.debug" \
-            --repo-name "EmergeTools/hackernews" \
-            --tag "snapshot" \
-            --debug \
-            --client-library paparazzi \
-            --project-root .

.github/workflows/ios_emerge_upload_snapshots.yml

@@ -1,12 +1,12 @@
-name: Sentry PR iOS Upload (Build Distribution)
+name: Sentry iOS PR Build Distribution
 
 on:
   pull_request:
     branches: [main]
     paths: [ios/**]
 
 jobs:
-  build_adhoc:
+  build_distribution:
     runs-on: macos-26
 
     defaults:
@@ -24,6 +24,7 @@ jobs:
         with:
           ruby-version: 3.3.10
           bundler-cache: true
+          working-directory: ios
 
       - name: Setup gems
         run: exec ../.github/scripts/ios/setup.sh
@@ -33,24 +34,25 @@ jobs:
           CERTIFICATE_BASE64: ${{ secrets.IOS_DIST_SIGNING_KEY_BASE64 }}
         run: |
           echo $CERTIFICATE_BASE64 | base64 --decode > signing-cert.p12
-      - name: Replace API key in Constants file
+
+      - name: Build Ad Hoc app and upload build to Sentry
         run: |
-          sed -i '' "s/API_KEY/$ETDISTRIBUTION_API_KEY/g" HackerNews/Utils/Constants.swift
-        env:
-          ETDISTRIBUTION_API_KEY: ${{ secrets.ETDISTRIBUTION_API_KEY_IOS }}
-      - name: Build & upload iOS AdHoc binary to Sentry
-        run: bundle exec fastlane ios build_upload_emerge
+          python3 - <<'PY'
+          import os
+          from pathlib import Path
+          path = Path("HackerNews/Utils/Constants.swift")
+          path.write_text(path.read_text().replace("SENTRY_DISTRIBUTION_AUTH_TOKEN", os.environ["SENTRY_DISTRIBUTION_AUTH_TOKEN"]))
+          PY
+          bundle exec fastlane ios build_upload_sentry_distribution
         env:
           ASC_KEY_ID: ${{ secrets.ASC_KEY_ID }}
           ASC_ISSUER_ID: ${{ secrets.ASC_ISSUER_ID }}
           ASC_KEY: ${{ secrets.ASC_PRIVATE_KEY }}
           SIGNING_KEY_PASSWORD: ${{ secrets.IOS_DIST_SIGNING_KEY_PASSWORD }}
           SIGNING_KEY_FILE_PATH: signing-cert.p12
-          EMERGE_API_TOKEN: ${{ secrets.EMERGE_API_KEY }}
-          SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_SENTRY_AUTH_TOKEN }}
+          SENTRY_SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_SENTRY_AUTH_TOKEN }}
+          SENTRY_DISTRIBUTION_AUTH_TOKEN: ${{ secrets.SENTRY_DISTRIBUTION_AUTH_TOKEN }}
           CONFIGURATION: AdHoc
-          EMERGE_BUILD_TYPE: pull-request-adhoc
           PROV_PROFILE_NAME: HackerNews AdHoc Distribution
           WIDGET_PROV_PROFILE_NAME: HackerNews AdHoc HomeWidget
           ADHOC: true
-          APP_ID_SUFFIX: adhoc

…ub/workflows/ios_emerge_upload_adhoc.yml …ub/workflows/ios_sentry_upload_adhoc.yml.github/workflows/ios_emerge_upload_adhoc.yml renamed to .github/workflows/ios_sentry_upload_adhoc.yml .github/workflows/ios_emerge_upload_adhoc.yml renamed to .github/workflows/ios_sentry_upload_adhoc.yml

@@ -1,11 +1,11 @@
-name: Sentry iOS Upload (Size Analysis)
+name: Sentry iOS Main Builds
 
 on:
   push:
     branches: [main]
 
 jobs:
-  build:
+  testflight_release:
     runs-on: macos-26
 
     defaults:
@@ -23,6 +23,7 @@ jobs:
         with:
           ruby-version: 3.3.10
           bundler-cache: true
+          working-directory: ios
 
       - name: Setup gems
         run: exec ../.github/scripts/ios/setup.sh
@@ -33,22 +34,19 @@ jobs:
         run: |
           echo $CERTIFICATE_BASE64 | base64 --decode > signing-cert.p12
 
-      # This version uploads a build to Testflight
-      - name: Build & upload iOS size analysis binary to Sentry
-        run: bundle exec fastlane ios build_upload_testflight
+      - name: Build, upload to TestFlight, and upload build metadata to Sentry
+        run: bundle exec fastlane ios build_upload_testflight_candidate
         env:
           ASC_KEY_ID: ${{ secrets.ASC_KEY_ID }}
           ASC_ISSUER_ID: ${{ secrets.ASC_ISSUER_ID }}
           ASC_KEY: ${{ secrets.ASC_PRIVATE_KEY }}
           SIGNING_KEY_PASSWORD: ${{ secrets.IOS_DIST_SIGNING_KEY_PASSWORD }}
           SIGNING_KEY_FILE_PATH: signing-cert.p12
-          EMERGE_API_TOKEN: ${{ secrets.EMERGE_API_KEY }}
           SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
           SENTRY_SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_SENTRY_AUTH_TOKEN }}
           CONFIGURATION: Release
-          EMERGE_BUILD_TYPE: release
 
-  build_adhoc:
+  build_distribution:
     runs-on: macos-26
 
     defaults:
@@ -66,6 +64,7 @@ jobs:
         with:
           ruby-version: 3.3.10
           bundler-cache: true
+          working-directory: ios
 
       - name: Setup gems
         run: exec ../.github/scripts/ios/setup.sh
@@ -76,20 +75,24 @@ jobs:
         run: |
           echo $CERTIFICATE_BASE64 | base64 --decode > signing-cert.p12
 
-      - name: Build & upload iOS AdHoc binary to Sentry
-        run: bundle exec fastlane ios build_upload_emerge
+      - name: Build Ad Hoc app and upload build to Sentry
+        run: |
+          python3 - <<'PY'
+          import os
+          from pathlib import Path
+          path = Path("HackerNews/Utils/Constants.swift")
+          path.write_text(path.read_text().replace("SENTRY_DISTRIBUTION_AUTH_TOKEN", os.environ["SENTRY_DISTRIBUTION_AUTH_TOKEN"]))
+          PY
+          bundle exec fastlane ios build_upload_sentry_distribution
         env:
           ASC_KEY_ID: ${{ secrets.ASC_KEY_ID }}
           ASC_ISSUER_ID: ${{ secrets.ASC_ISSUER_ID }}
           ASC_KEY: ${{ secrets.ASC_PRIVATE_KEY }}
           SIGNING_KEY_PASSWORD: ${{ secrets.IOS_DIST_SIGNING_KEY_PASSWORD }}
           SIGNING_KEY_FILE_PATH: signing-cert.p12
-          EMERGE_API_TOKEN: ${{ secrets.EMERGE_API_KEY }}
-          SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
           SENTRY_SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_SENTRY_AUTH_TOKEN }}
+          SENTRY_DISTRIBUTION_AUTH_TOKEN: ${{ secrets.SENTRY_DISTRIBUTION_AUTH_TOKEN }}
           CONFIGURATION: AdHoc
-          EMERGE_BUILD_TYPE: main-adhoc
           PROV_PROFILE_NAME: HackerNews AdHoc Distribution
           WIDGET_PROV_PROFILE_NAME: HackerNews AdHoc HomeWidget
           ADHOC: true
-          APP_ID_SUFFIX: adhoc

…hub/workflows/ios_emerge_upload_main.yml …hub/workflows/ios_sentry_upload_main.yml.github/workflows/ios_emerge_upload_main.yml renamed to .github/workflows/ios_sentry_upload_main.yml .github/workflows/ios_emerge_upload_main.yml renamed to .github/workflows/ios_sentry_upload_main.yml

@@ -1,12 +1,12 @@
-name: Emerge PR iOS Upload (Size Analysis)
+name: Sentry iOS PR Size Analysis
 
 on:
   pull_request:
     branches: [main]
     paths: [ios/**]
 
 jobs:
-  build:
+  size_analysis:
     runs-on: macos-26
 
     defaults:
@@ -24,6 +24,7 @@ jobs:
         with:
           ruby-version: 3.3.10
           bundler-cache: true
+          working-directory: ios
 
       - name: Setup gems
         run: exec ../.github/scripts/ios/setup.sh
@@ -34,16 +35,13 @@ jobs:
         run: |
           echo $CERTIFICATE_BASE64 | base64 --decode > signing-cert.p12
 
-      - name: Build & upload iOS size analysis binary to Emerge Tools
-        run: bundle exec fastlane ios build_upload_emerge
+      - name: Build Release app and upload thinned IPA to Sentry
+        run: bundle exec fastlane ios build_upload_sentry_size_analysis
         env:
           ASC_KEY_ID: ${{ secrets.ASC_KEY_ID }}
           ASC_ISSUER_ID: ${{ secrets.ASC_ISSUER_ID }}
           ASC_KEY: ${{ secrets.ASC_PRIVATE_KEY }}
           SIGNING_KEY_PASSWORD: ${{ secrets.IOS_DIST_SIGNING_KEY_PASSWORD }}
           SIGNING_KEY_FILE_PATH: signing-cert.p12
-          EMERGE_API_TOKEN: ${{ secrets.EMERGE_API_KEY }}
-          SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
           SENTRY_SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_SENTRY_AUTH_TOKEN }}
           CONFIGURATION: Release
-          EMERGE_BUILD_TYPE: pull-request