For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Discord
DocsAPI Reference
DocsAPI Reference
  • Get Started
    • Welcome
    • Introduction
    • Quick Start
  • Run
    • Run Videos
    • Run Mode
    • Viewport Size
    • Preparation Test
    • Pull Request Testing
    • Production Monitoring
    • Group Webhooks
    • Run Troubleshooting
  • Auth
    • Test Credentials
    • API Keys
    • Agent Mail Inboxes
    • HTTP Basic Auth
    • Auth Troubleshooting
  • Mobile
    • Overview
    • App Uploads
    • Expo EAS
    • GitHub Actions
  • Integrations
    • Vercel
    • Coolify
    • Custom Infrastructure
    • Slack
    • Discord
    • Email
  • Guides
    • Testing Staging Environment
  • CLI
    • Getting Started
    • Local Development
    • Agentic Usage
  • AI
    • LLMs
LogoLogo
Discord
On this page
  • Recommended setup
  • Supported platforms
  • Requirements
  • Limitations
  • Next steps
Mobile

Overview

||View as Markdown|
Was this page helpful?
Edit this page
Previous

Auth Troubleshooting

Next

App Uploads

Built with

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 Run Videos for details.

Mobile testing flow

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 or GitHub Actions so the same tests run automatically on every change.

If you want a working reference, see the mobile GitHub Action and the mobile example app.

Supported platforms

PlatformSystem VersionType
iOS26.4Simulator
Android15Emulator

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 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.

Next steps

Build and upload your app

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

Set up GitHub Actions

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

Set up Expo EAS

Run TesterArmy mobile tests from Expo EAS workflows.