Maestro

What is Maestro?

Maestro is an open-source framework that makes UI and end-to-end testing for Android, iOS, and web apps simple and fast. It uses human-readable YAML flows and runs on any emulator, simulator, or browser.

How to use Maestro?

Install Maestro via a single curl command on macOS, Linux, or Windows (WSL), then write YAML flow files with commands like launchApp, tapOn, and assertVisible. Run tests directly from the CLI without compilation.

Key features of Maestro

• Cross-platform coverage for Android, iOS, and web apps.
• Human-readable YAML flows for test authoring.
• Built-in flakiness tolerance and automatic waiting.
• No compilation needed – flows are interpreted instantly.
• Simple one‑command installation.

Use cases of Maestro

• Write and run end-to-end tests for mobile and web apps.
• Iterate quickly on UI changes with interpreted YAML flows.
• Scale test execution across multiple devices via Maestro Cloud.
• Use visual flow builder (Maestro Studio) for no‑terminal testing.

FAQ from Maestro

What does Maestro require to run?

Maestro requires Java 17 or higher installed on your system. Verify with java -version.

How do I install Maestro?

Run curl -fsSL "https://get.maestro.mobile.dev" | bash on macOS, Linux, or Windows (WSL). Regular Windows installation is covered in the documentation.

Which platforms and frameworks does Maestro support?

Maestro supports Android, iOS, and web apps, including React Native, Flutter, and hybrid apps. Tests run on emulators, simulators, or real devices.

Is Maestro open‑source?

Yes, Maestro is open-source under the Apache 2.0 license. Contributions are welcome via GitHub.

What is Maestro Cloud and how does it relate to Maestro?

Maestro Cloud is a paid service that runs tests in parallel on dedicated infrastructure, cutting execution times by up to 90%. It includes notifications, deterministic environments, and debugging tools. Pricing is transparent and a free 7‑day trial is available.