https://github.com/mobile-dev-inc/maestro

Painless Mobile UI Automation
https://github.com/mobile-dev-inc/maestro

android blackbox-testing ios ui-automation

Last synced: 3 days ago
JSON representation

Painless Mobile UI Automation

• Host: GitHub
• URL: https://github.com/mobile-dev-inc/maestro
• Owner: mobile-dev-inc
• License: apache-2.0
• Created: 2022-03-31T18:17:40.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2025-01-02T23:28:18.000Z (9 days ago)
• Last Synced: 2025-01-03T14:50:10.507Z (8 days ago)
• Topics: android, blackbox-testing, ios, ui-automation
• Language: Kotlin
• Homepage: https://maestro.mobile.dev/
• Size: 269 MB
• Stars: 5,992
• Watchers: 49
• Forks: 294
• Open Issues: 415
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-list - mobile-dev-inc/maestro - Painless Mobile UI Automation (Kotlin)
• awesome - Maestro - End to end tests (Testing / Javascript)
• awesome - mobile-dev-inc/maestro - Painless Mobile UI Automation (Kotlin)

README

        
# Maestro

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



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

## Resources

### Documentation

**Available at [maestro.mobile.dev](https://maestro.mobile.dev)**

To get more background on why we built Maestro, read [the Maestro announcement blogpost][blogpost].

### Community

We invite everyone to [join our public Slack channel](https://docsend.com/view/3r2sf8fvvcjxvbtk).

### Contributing

Maestro is an open-source project and we love getting contributions.

To get started, take a look at [issues with the `good first issue` label][good first issues] and [the contributing guide](./CONTRIBUTING.md).

### Built by

[mobile.dev](https://www.mobile.dev)

![](./logo.png)

[good first issues]: https://github.com/mobile-dev-inc/maestro/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22

[blogpost]: https://blog.mobile.dev/introducing-maestro-painless-mobile-ui-automation-bee4992d13c1