> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://tester.army/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://tester.army/_mcp/server.

# Overview

TesterArmy runs your app on cloud simulators/emulators and uses AI agents to test it like a real user.

Every completed mobile run includes a downloadable simulator/emulator video, just like web runs. TesterArmy handles capture, storage, and playback automatically, so you do not need to record the session yourself. See [Understand Results](/run/results) for the result model and [Run Videos](/run/videos) for recording details.

![Mobile testing flow](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/testerarmy-subpath.docs.buildwithfern.com/81eb2c5d3d559e2f27f1af3a2f8215b9b6c173b4faef2be2ffa07189a613d4da/docs/assets/docs/mobile-test-run.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260817%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260817T151314Z&X-Amz-Expires=604800&X-Amz-Signature=27aab7ed481bbdb5d814bd60e38aae724b0b4d5be67fe5cff323a54339e88635&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

## Recommended setup

1. Build an iOS Simulator version of your app and zip the `.app` bundle, or build an Android `.apk` / `.apks`.
2. Upload that build to TesterArmy and create your first mobile test.
3. Run the test manually to confirm everything works.
4. Add [Expo EAS](/mobile/expo-eas) or [GitHub Actions](/mobile/github-actions) so the same tests run automatically on every change.

If you want a working reference, see the [mobile GitHub Action](https://github.com/tester-army/mobile-github-action) and the [mobile example app](https://github.com/tester-army/mobile-example).

## Supported platforms

| Platform | System Version | Type      | Devices      |
| -------- | -------------- | --------- | ------------ |
| iOS      | 26.4           | Simulator | iPhone, iPad |
| Android  | 15             | Emulator  | Phone        |

## Device selection

iOS tests run on iPhone by default. To run on iPad, pick **iPad** in the
dashboard run menu, or pass `deviceModel: "ipad"` when triggering runs via the
API or the CLI (`--device-model ipad`).

iPad runs require a build with **native iPad support** (a universal app). iPhone-only builds
launch on iPad in scaled compatibility mode, which cannot be automated reliably — those runs fail
during setup with a clear error instead of producing misleading results.

## Requirements

TesterArmy currently supports simulator/emulator builds only. For iOS, that means you need a `.app` bundle built for **iOS Simulator**, not an `.ipa` built for physical devices. For Android, upload a single `.apk` or a split APK archive (`.apks`). `.aab` and `.xapk` are not supported.

For manual iOS uploads, archive the simulator build as `.app.zip`. If you use our GitHub Action, you can pass the `.app` directory directly and the action handles the upload for you.

See [App Uploads](/mobile/app-uploads) for the build and zip steps.

## Limitations

Currently we support running tests on simulators only, so features like camera access and biometric access (Face ID, Touch ID) are not supported.
If you need to run tests on real devices please [contact us](mailto:support@tester.army).

## Next steps

#### [Build and upload your app](/mobile/app-uploads)

Build an iOS Simulator .app or Android APK, upload it, and create your first mobile test.

#### [Set up GitHub Actions](/mobile/github-actions)

Run your existing mobile tests automatically in CI with our GitHub Action.

#### [Set up Expo EAS](/mobile/expo-eas)

Run TesterArmy mobile tests from Expo EAS workflows.

#### [Test Apple Pay](/mobile/apple-pay)

Exercise Apple Pay checkout flows in your iOS app, from payment sheet to success screen.