End-to-End Testing with Detox

.detoxrc.js

@@ -0,0 +1,66 @@
+const launchArgs = {
+  disableAnimations: true,
+};
+
+/** @type {Detox.DetoxConfig} */
+module.exports = {
+  testRunner: {
+    args: {
+      $0: "jest",
+      config: "e2e/jest.config.ts",
+    },
+    jest: {
+      setupTimeout: 120000,
+    },
+  },
+  apps: {
+    "ios.release": {
+      launchArgs,
+      type: "ios.app",
+      binaryPath:
+        "ios/build/Build/Products/Release-iphonesimulator/evcc.app",
+      build:
+        "xcodebuild -workspace ios/evcc.xcworkspace -scheme evcc -configuration Release -sdk iphonesimulator -arch arm64 -derivedDataPath ios/build",
+    },
+    "android.release": {
+      launchArgs,
+      type: "android.apk",
+      binaryPath: "android/app/build/outputs/apk/release/app-release.apk",
+      build: `cd android && "./gradlew" assembleRelease assembleAndroidTest -DtestBuildType=release`,
+    },
+  },
+  devices: {
+    simulator: {
+      type: "ios.simulator",
+      device: {
+        type: "iPhone 16",
+      },
+    },
+    attached: {
+      type: "android.attached",
+      device: {
+        adbName: ".*",
+      },
+    },
+    emulator: {
+      type: "android.emulator",
+      device: {
+        avdName: "test",
+      },
+    },
+  },
+  configurations: {
+    "ios.sim.release": {
+      device: "simulator",
+      app: "ios.release",
+    },
+    "android.att.release": {
+      device: "attached",
+      app: "android.release",
+    },
+    "android.emu.release": {
+      device: "emulator",
+      app: "android.release",
+    },
+  },
+};

.github/workflows/ci.yaml

@@ -6,19 +6,156 @@ on:
   pull_request:
     branches: [main]
 
+permissions:
+  contents: read
+
 jobs:
-  build:
+  lint:
+    name: Lint
     runs-on: ubuntu-latest
+    timeout-minutes: 10
 
     steps:
-      - uses: actions/checkout@v4
-      - name: Use Node.js
-        uses: actions/setup-node@v4
+      - name: Checkout
+        uses: actions/checkout@v6.0.0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6.0.0
         with:
-          node-version: "21"
+          node-version: "24"
+          cache: "npm"
 
       - name: Install dependencies
-        run: npm install --legacy-peer-deps
+        run: npm ci
 
-      - name: Run Linter
+      - name: Lint
         run: npm run lint
+
+  fastlane-validate:
+    name: Fastlane Metadata
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6.0.0
+
+      - name: Validate
+        uses: ashutoshgngwr/validate-fastlane-supply-metadata@v2.1.0
+        with:
+          usePlayStoreLocales: true
+
+  ios-detox:
+    name: iOS Detox
+    runs-on: depot-macos-15
+    timeout-minutes: 45
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6.0.0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6.0.0
+        with:
+          node-version: "24"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Setup Expo
+        run: npx expo install
+
+      - name: Prebuild iOS
+        run: npx expo prebuild --platform ios --clean
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1.268.0
+        with:
+          ruby-version: "3.2"
+          bundler-cache: false
+
+      - name: Generate codegen
+        run: |
+          node node_modules/react-native/scripts/generate-codegen-artifacts.js \
+            --path . \
+            --outputPath ios/build/generated/ios
+
+      - name: Install CocoaPods
+        working-directory: ios
+        run: pod install
+
+      - name: Boot simulator
+        run: |
+          xcrun simctl boot "iPhone 16" || true
+          xcrun simctl list devices | grep "iPhone 16"
+
+      - name: Build
+        run: npx detox build --configuration ios.sim.release
+
+      - name: Test
+        run: npx detox test --configuration ios.sim.release --cleanup
+
+      - name: Upload artifacts on failure
+        if: failure()
+        uses: actions/upload-artifact@v5.0.0
+        with:
+          name: ios-detox-artifacts
+          path: e2e/artifacts/
+          retention-days: 7
+
+  android-detox:
+    name: Android Detox
+    runs-on: depot-ubuntu-24.04-8
+    timeout-minutes: 45
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6.0.0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6.0.0
+        with:
+          node-version: "24"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Setup Expo
+        run: npx expo install
+
+      - name: Prebuild Android
+        run: npx expo prebuild --platform android --clean
+
+      - 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: Setup Java
+        uses: actions/setup-java@v5.0.0
+        with:
+          distribution: "temurin"
+          java-version: "17"
+
+      - name: Build and test
+        uses: reactivecircus/android-emulator-runner@v2.35.0
+        with:
+          api-level: 34
+          target: google_apis
+          arch: x86_64
+          emulator-options: -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim
+          disable-animations: true
+          script: |
+            npx detox build --configuration android.emu.release
+            npx detox test --configuration android.emu.release --cleanup
+
+      - name: Upload artifacts on failure
+        if: failure()
+        uses: actions/upload-artifact@v5.0.0
+        with:
+          name: android-detox-artifacts
+          path: e2e/artifacts/
+          retention-days: 7

.gitignore

@@ -6,3 +6,4 @@ android/
 !fastlane/metadata/ios
 caddy*.*
 tsconfig.tsbuildinfo
+.claude/

app.config.ts

@@ -61,7 +61,10 @@ export default ({ config }: ConfigContext) =>
       plugins: [
         ["./scripts/fdroid/removeDKBuildId.ts"],
         ["./scripts/fdroid/disableDependencyMetadata.ts"],
-        ["./scripts/fdroid/excludeNonfreeDependencies.ts"],
+        [
+          "./scripts/detox/configureDetox.ts",
+          // { subdomains: "*" }, // uncomment to debug app
+        ],
         [
           "expo-build-properties",
           {

components/ServerForm.tsx

@@ -1,7 +1,7 @@
 import React, { useRef, useState } from "react";
 import { Text, Button, Input, CheckBox } from "@ui-kitten/components";
 import { cleanServerUrl, verifyEvccServer } from "../utils/server";
-import LoadingIndicator from "../components/LoadingIndicator";
+import LoadingIndicator from "./animations/LoadingIndicator";
 import { useTranslation } from "react-i18next";
 import { BasicAuth } from "types";
 

components/animations/ActivityIndicator.tsx

@@ -0,0 +1,11 @@
+import { ActivityIndicatorProps, View } from "react-native";
+import { ActivityIndicator as RNActivityIndicator } from "react-native";
+import { disableAnimations } from "./launchArguments";
+
+export default function ActivityIndicator(props?: ActivityIndicatorProps) {
+  return (
+    <View style={{ justifyContent: "center", alignItems: "center" }}>
+      <RNActivityIndicator {...props} animating={!disableAnimations()} />
+    </View>
+  );
+}

components/animations/LoadingIndicator.tsx

@@ -0,0 +1,11 @@
+import { View } from "react-native";
+import { SpinnerProps } from "@ui-kitten/components";
+import Spinner from "./Spinner";
+
+export default function LoadingIndicator(props?: SpinnerProps) {
+  return (
+    <View style={{ justifyContent: "center", alignItems: "center" }}>
+      <Spinner {...props} />
+    </View>
+  );
+}

components/animations/Spinner.tsx

@@ -0,0 +1,9 @@
+import {
+  SpinnerProps,
+  Spinner as UIKittenSpinner,
+} from "@ui-kitten/components";
+import { disableAnimations } from "./launchArguments";
+
+export default function Spinner(props: SpinnerProps) {
+  return <UIKittenSpinner {...props} animating={!disableAnimations()} />;
+}

components/animations/launchArguments.ts

@@ -0,0 +1,9 @@
+import { LaunchArguments } from "react-native-launch-arguments";
+
+interface LaunchArgs {
+  disableAnimations?: boolean;
+}
+
+export function disableAnimations(): boolean {
+  return !!LaunchArguments.value<LaunchArgs>().disableAnimations;
+}

e2e/jest.config.ts

@@ -0,0 +1,14 @@
+import { Config } from "@jest/types";
+
+module.exports = {
+  preset: "ts-jest",
+  rootDir: "..",
+  testMatch: ["<rootDir>/e2e/**/*.test.ts"],
+  testTimeout: 120000,
+  maxWorkers: 1,
+  globalSetup: "detox/runners/jest/globalSetup",
+  globalTeardown: "detox/runners/jest/globalTeardown",
+  reporters: ["detox/runners/jest/reporter"],
+  testEnvironment: "detox/runners/jest/testEnvironment",
+  verbose: true,
+} satisfies Config.InitialOptions;

e2e/starter.test.ts

@@ -0,0 +1,14 @@
+import "detox";
+
+describe("Example", () => {
+  beforeAll(async () => {
+    await device.launchApp();
+  });
+
+  it("open and leave demo server", async () => {
+    await element(by.id("useDemo")).tap();
+
+    await web.element(by.web.id("topNavigatonDropdown")).tap();
+    // await web.element(by.web.value("Change Server")).tap(); // TODO: use testID
+  });
+});