Examples overview

Real-world examples and recipes for common Maestro automation scenarios.

This section of the documentation is a curated library of real-world scenarios designed to bridge the gap between basic commands and complex, production-ready automation.

While the core documentation explains how commands work, this section focuses on implementation patterns, solving specific technical hurdles like system-level interactions, dynamic content, and scalable architecture.

Implementation Recipes

These guides provide targeted solutions for specific technical requirements:

• Choose images from the gallery: Learn the specific sequence needed to navigate out of your app, interact with the system photo picker, and return to your Flow.

• Check the clipboard content: See how to verify that your app correctly copied text or links to the device clipboard using JavaScript assertions.

• Download and open a file: A guide on handling "Save to Device" flows and verifying that files (like PDFs or images) are accessible.

• Custom scrolling for screen fragments: Master scrolling in complex layouts where elements are hidden inside sub-containers or fragments.

• Get the last matching element: Learn how to target a specific instance of an element when multiple identical items (like "Delete" buttons) appear in a list.

• Implementing the Page Object Model (POM): Learn how to separate your element selectors from your test logic. This is the industry-standard approach for reducing maintenance and making tests readable for the whole team.

• Test in different time zones (Android): Learn how to set the Android device time zone through the Settings app, by region or by UTC offset, to test features that depend on the time of day.

Real world examples

See how Maestro handles real-world complexity in popular applications.

• Automate Android Contacts Flow: A perfect starting point to see how Maestro interacts with native Android system apps using text and ID selectors.

• Automate Facebook Sign-Up (Android): Covers complex form filling, handling multiple screens, and navigating onboarding.

• Advanced: Wikipedia on Android: Demonstrates deep navigation, search interactions, and content verification.