What is Maestro?

Maestro is the simplest and most effective UI testing framework.

Running in the Cloud

Robin is the official Maestro cloud platform. Run your flows on Robin for the most stable, secure, and intelligent Maestro execution. Learn more at robintest.com

Why Maestro?

Maestro is built on learnings from its predecessors (Appium, Espresso, UIAutomator, XCTest, Selenium, Playwright) and allows you to easily define and test your Flows.

What are Flows? Think of Flows as parts of the user journey in your app. Login, Checkout and Add to Cart are three examples of possible Flows that can be defined and tested using Maestro.

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

Examples

Twitter (Mobile)

Simple Examples

# flow_contacts_android.yaml

appId: com.android.contacts
---
- launchApp
- tapOn: "Create new contact"
- tapOn: "First Name"
- inputText: "John"
- tapOn: "Last Name"
- inputText: "Snow"
- tapOn: "Save"

# flow_contacts_ios.yaml

appId: com.apple.MobileAddressBook
---
- launchApp
- tapOn: "John Appleseed"
- tapOn: "Edit"
- tapOn: "Add phone"
- inputText: "123123"
- tapOn: "Done"

url: https://example.com
---
- launchApp
- tapOn: More information...
- assertVisible: Further Reading

Platform Support

Platform

Support

iOS

✅

Android

✅

Web (Desktop)

✅

Web (WebView)

✅

ReactNative

✅

Flutter

✅

Resources

Blog Post: Introducing: Maestro — Painless Mobile UI Automation
GitHub Repository: https://github.com/mobile-dev-inc/maestro
Public Slack Channel: Join the workspace, then head to the #maestro channel

Get Started

Get started by installing the Maestro CLI:

NextInstalling Maestro

Last updated 13 days ago

Why Maestro?

Maestro is built on learnings from its predecessors (Appium, Espresso, UIAutomator, XCTest, Selenium, Playwright) and allows you to easily define and test your Flows.

What are Flows? Think of Flows as parts of the user journey in your app. Login, Checkout and Add to Cart are three examples of possible Flows that can be defined and tested using Maestro.

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

Examples

Twitter (Mobile)

Simple Examples

# flow_contacts_android.yaml

appId: com.android.contacts
---
- launchApp
- tapOn: "Create new contact"
- tapOn: "First Name"
- inputText: "John"
- tapOn: "Last Name"
- inputText: "Snow"
- tapOn: "Save"

# flow_contacts_ios.yaml

appId: com.apple.MobileAddressBook
---
- launchApp
- tapOn: "John Appleseed"
- tapOn: "Edit"
- tapOn: "Add phone"
- inputText: "123123"
- tapOn: "Done"

url: https://example.com
---
- launchApp
- tapOn: More information...
- assertVisible: Further Reading