From 71442bb85adb0c091dc241f3e6b0de01ad8c62b6 Mon Sep 17 00:00:00 2001
From: PJ <ipriyanshujain@gmail.com>
Date: Sun, 16 Aug 2026 01:22:25 +0530
Subject: [PATCH] ci(examples): add the folio setup actions

folio-app holds the per-platform toolchain and app build, so a caller
guards one step instead of eight. folio-simulator boots the simulator,
installs folio and leaves the app stopped.
---
 .github/actions/folio-app/action.yml       | 81 ++++++++++++++++++++++
 .github/actions/folio-simulator/action.yml | 31 +++++++++
 2 files changed, 112 insertions(+)
 create mode 100644 .github/actions/folio-app/action.yml
 create mode 100644 .github/actions/folio-simulator/action.yml

diff --git a/.github/actions/folio-app/action.yml b/.github/actions/folio-app/action.yml
new file mode 100644
index 0000000..f036868
--- /dev/null
+++ b/.github/actions/folio-app/action.yml
@@ -0,0 +1,81 @@
+name: folio app
+description: Install the toolchain folio needs on one platform, and build the app there.
+
+inputs:
+  platform:
+    description: android, ios or web
+    required: true
+
+runs:
+  using: composite
+  steps:
+    - name: Set up the JDKs
+      uses: actions/setup-java@v5
+      with:
+        distribution: temurin
+        # The metro gradle plugin folio builds with needs a 21 runtime; the
+        # sidecar toolchain pins 17. Both are installed so gradle can pick.
+        java-version: |
+          17
+          21
+
+    # The iOS app builds its Kotlin framework through the folio gradle project,
+    # which configures :app:androidApp, so this is needed off Android too.
+    # `make sanderling-android` wants it as well, for the sidecar JAR.
+    - name: Set up Android SDK
+      if: inputs.platform != 'web'
+      uses: android-actions/setup-android@40fd30fb8d7440372e1316f5d1809ec01dcd3699 # v4.0.1
+
+    - name: Cache Gradle
+      if: inputs.platform != 'ios'
+      uses: actions/cache@v6
+      with:
+        path: |
+          ~/.gradle/caches
+          ~/.gradle/wrapper
+        key: folio-gradle-${{ runner.os }}-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
+        restore-keys: |
+          folio-gradle-${{ runner.os }}-
+
+    # idb-companion is not in homebrew-core, only in facebook/homebrew-fb, so
+    # it has to be named by its full tap path. xcodegen and just are core.
+    - name: Install idb-companion, xcodegen and just
+      if: inputs.platform == 'ios'
+      shell: bash
+      run: brew install facebook/fb/idb-companion xcodegen just
+
+    # Both asset tarballs are built by the prepare scripts, and the runner
+    # bundle is an xcodebuild of companion/Sources. Keyed on the scripts and
+    # the versions the Makefile embeds, so a later run reuses them. This has to
+    # land before `make sanderling-ios`, which is what consumes them.
+    - name: Cache the companion and runner bundles
+      if: inputs.platform == 'ios'
+      uses: actions/cache@v6
+      with:
+        path: |
+          internal/driver/ioscompanion/companionassets/assets
+          internal/driver/ioscompanion/runnerassets/assets
+        key: ios-assets-${{ runner.os }}-${{ hashFiles('internal/driver/ioscompanion/companionassets/prepare.sh', 'companion/prepare.sh', 'companion/project.yml', 'companion/Sources/**') }}
+
+    # Without this the emulator falls back to software rendering and every
+    # step costs several seconds.
+    - name: Enable KVM
+      if: inputs.platform == 'android'
+      shell: bash
+      run: |
+        echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' \
+          | sudo tee /etc/udev/rules.d/99-kvm4all.rules
+        sudo udevadm control --reload-rules
+        sudo udevadm trigger --name-match=kvm
+
+    - name: Build the folio APK
+      if: inputs.platform == 'android'
+      shell: bash
+      working-directory: examples/folio
+      run: ./gradlew :app:androidApp:assembleDebug
+
+    - name: Build the folio wasmJs app
+      if: inputs.platform == 'web'
+      shell: bash
+      working-directory: examples/folio
+      run: ./gradlew :app:webApp:wasmJsBrowserDevelopmentExecutableDistribution
diff --git a/.github/actions/folio-simulator/action.yml b/.github/actions/folio-simulator/action.yml
new file mode 100644
index 0000000..36dcd1f
--- /dev/null
+++ b/.github/actions/folio-simulator/action.yml
@@ -0,0 +1,31 @@
+name: folio on a simulator
+description: Boot an iOS simulator, install folio on it, and leave the app stopped.
+
+inputs:
+  device:
+    description: simulator device name
+    default: iPhone 16 Pro
+
+runs:
+  using: composite
+  steps:
+    - name: Boot a simulator
+      shell: bash
+      run: |
+        xcrun simctl boot "$IOS_DEVICE" || true
+        xcrun simctl bootstatus "$IOS_DEVICE" -b
+      env:
+        IOS_DEVICE: ${{ inputs.device }}
+
+    - name: Build and install folio
+      shell: bash
+      working-directory: examples/folio
+      run: just ios
+      env:
+        IOS_DEVICE: ${{ inputs.device }}
+
+    # `just ios` leaves the app running, and the run's first act is to clear
+    # its state. Stopping it here means the run always opens the same way.
+    - name: Stop the app before the run
+      shell: bash
+      run: xcrun simctl terminate booted app.folio || true