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.

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.