> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.tester.army/mobile/llms.txt.
> For full documentation content, see https://docs.tester.army/mobile/llms-full.txt.

# Overview

> **Warning: Early Access**
>
> Mobile testing is currently in early access. To get access, please [contact
> us](https://tester.army/meet).

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

![Mobile testing flow](https://files.buildwithfern.com/testerarmy.docs.buildwithfern.com/81eb2c5d3d559e2f27f1af3a2f8215b9b6c173b4faef2be2ffa07189a613d4da/docs/assets/docs/mobile-test-run.png)

## Recommended setup

1. Build an iOS Simulator version of your app and zip the `.app` bundle.
2. Upload that build to TesterArmy and create your first mobile test.
3. Run the test manually to confirm everything works.
4. Add 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      |
| -------- | -------------- | --------- |
| iOS      | 26.0           | Simulator |

Android support is coming soon. [Let us know](mailto:support@tester.army) if you'd like to be notified when it's available.

## Requirements

TesterArmy currently supports simulator builds only. For iOS, that means you need a `.app` bundle built for **iOS Simulator**, not an `.ipa` built for physical devices.

For manual uploads, archive the simulator build as `.app.zip` or `.app.tar.gz`. 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

<CardGroup cols={2}>
  <Card title="Build and upload your app" icon="fa-duotone fa-cloud-arrow-up" href="/mobile/app-uploads">
    Build a simulator .app, zip it, upload it, and create your first mobile test.
  </Card>

  <Card title="Set up GitHub Actions" icon="fa-brands fa-github" href="/mobile/ci-integration">
    Run your existing mobile tests automatically in CI with our GitHub Action.
  </Card>
</CardGroup>