Maestro ?

Maestro is the easiest way to automate UI testing for your mobile app.

Full documentation for Maestro can be found at


Create a flow for any app on Android and iOS, with just a few lines of YAML.

Android iOS

# flow_contacts_android.yaml

- launchApp
- tapOn: "Create new contact"
- tapOn: "First Name"
- inputText: "John"
- tapOn: "Last Name"
- inputText: "Snow"
- tapOn: "Save"

# flow_contacts_ios.yaml

- launchApp
- tapOn: "John Appleseed"
- tapOn: "Edit"
- tapOn: "Add phone"
- inputText: "123123"
- tapOn: "Done"

Quick Start

Get a CLI tool from homebrew

brew tap mobile-dev-inc/tap
brew install maestro

Write a simple test in a YAML file

# flow.yaml

- launchApp
- tapOn: "Text on the screen"

Make sure an Android emulator is running. Check out the docs for physical device support.

Run it!

maestro test flow.yaml

iOS Support

Only iOS Simulators are supported at the moment.

For Maestro to work with iOS you would need to do few extra steps.

Install Facebook IDB tool

brew tap facebook/fb
brew install idb-companion

And launch it:

idb_companion --udid {id of the iOS device}

Why Maestro?

Maestro is built on learnings from its predecessors (Appium, Espresso, UIAutomator, XCTest)

  • Built-in tolerance to flakiness. UI elements will not always be where you expect them, screen tap will not always go through, etc. Maestro embraces the instability of mobile applications and devices and tries to counter it.
  • Built-in tolerance to delays. No need to pepper your tests with sleep() calls. Maestro knows that it might take time to load the content (i.e. over the network) and automaitcally waits for it (but no longer than required).
  • Blazingly fast iteration. Tests are interpreted, no need to compile anything. Maestro is able to continuously monitor your test files and rerun them as they change.
  • Declarative yet powerful syntax. Define your tests in a yaml file.
  • Simple setup. Maestro is a single binary that works anywhere.

Next steps


View Github