Add Maestro smoke test for app launch verification

Enable WebView debugging in debug builds so Maestro can inspect
WebView content via devtools. Add a minimal smoke test flow that
launches the app and waits for visible content. Add Makefile targets
for installing Maestro and running smoke tests, and a CI job that
boots an emulator and runs the smoke test against the built APK.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: rtibbles

.github/workflows/build_and_test.yml

@@ -93,3 +93,45 @@ jobs:
         path: tar
     - name: Run unit tests
       run: ./gradlew test
+
+  smoke_test:
+    name: Smoke test
+    needs: [pre_job, build_apk]
+    if: ${{ needs.pre_job.outputs.should_skip != 'true' }}
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v6
+    - name: Set up JDK 17
+      uses: actions/setup-java@v4
+      with:
+        distribution: 'temurin'
+        java-version: '17'
+    - name: Install Maestro CLI
+      run: make maestro-install
+    - name: Add Maestro to PATH
+      run: echo "$HOME/.maestro/bin" >> $GITHUB_PATH
+    - name: Enable KVM
+      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: Download APK artifact
+      uses: actions/download-artifact@v7
+      with:
+        name: ${{ needs.build_apk.outputs.apk-file-name }}
+        path: dist
+    - name: Run smoke test
+      uses: reactivecircus/android-emulator-runner@v2
+      with:
+        api-level: 30
+        arch: x86_64
+        target: google_apis
+        script: |
+          adb install -r dist/*.apk
+          make smoke-test
+    - name: Upload Maestro debug output
+      if: always()
+      uses: actions/upload-artifact@v6
+      with:
+        name: maestro-debug-output
+        path: ~/.maestro/tests/

.maestro/smoke.yaml

@@ -0,0 +1,27 @@
+appId: org.learningequality.Kolibri
+androidWebViewHierarchy: devtools
+---
+# Launch app and wait for the setup wizard to load
+- launchApp
+- extendedWaitUntil:
+    visible: "How are you using Kolibri?"
+    timeout: 120000
+
+# Dismiss notification permission dialog if it appears
+- tapOn:
+    text: "ALLOW"
+    optional: true
+
+# Step 1: "How are you using Kolibri?" — "On my own" is pre-selected
+- tapOn: "CONTINUE"
+
+# Step 2: "Please select the default language" — English is pre-selected
+- extendedWaitUntil:
+    visible: "Please select the default language for Kolibri"
+    timeout: 10000
+- tapOn: "CONTINUE"
+
+# Verify we reach the main app (Library page)
+- extendedWaitUntil:
+    visible: "Your library"
+    timeout: 30000

.pre-commit-config.yaml

@@ -13,6 +13,7 @@ repos:
         hooks:
             -   id: trailing-whitespace
             -   id: check-yaml
+                args: ['--allow-multiple-documents']
             -   id: check-added-large-files
             -   id: debug-statements
             -   id: end-of-file-fixer

Makefile

@@ -195,6 +195,24 @@ list-avds:
 clean-tools:
 	rm -rf $(SDK)
 
+# =============================================================================
+# Maestro Smoke Testing
+# =============================================================================
+
+MAESTRO_VERSION := 2.1.0
+MAESTRO := $(HOME)/.maestro/bin/maestro
+
+$(MAESTRO):
+	@echo "Installing Maestro $(MAESTRO_VERSION)..."
+	MAESTRO_VERSION=$(MAESTRO_VERSION) curl -fsSL "https://get.maestro.mobile.dev" | bash
+
+.PHONY: maestro-install
+maestro-install: $(MAESTRO)
+
+.PHONY: smoke-test
+smoke-test: maestro-install
+	$(MAESTRO) test .maestro/
+
 # =============================================================================
 # Logging
 # =============================================================================
@@ -230,6 +248,8 @@ help:
 	@echo "  test                  - Run unit tests"
 	@echo "  lint                  - Run Android linter"
 	@echo "  clean                 - Clean build artifacts"
+	@echo "  maestro-install       - Install Maestro CLI"
+	@echo "  smoke-test            - Run Maestro smoke tests (requires running emulator + installed APK)"
 	@echo ""
 	@echo "SDK & Emulator Setup:"
 	@echo "  setup                 - Complete setup (SDK + system image + AVD)"

app/src/main/java/org/learningequality/Kolibri/WebViewActivity.java

@@ -81,6 +81,10 @@ public void handleOnBackPressed() {
   }
 
   private void setupWebView() {
+    if (BuildConfig.DEBUG) {
+      WebView.setWebContentsDebuggingEnabled(true);
+    }
+
     WebView webView = findViewById(R.id.webview);
     fullscreenContainer = findViewById(R.id.fullscreen_container);
     splashImage = findViewById(R.id.splash_image);