maestro-e2e

Run Maestro end-to-end UI test flows from YAML definitions across platforms.

7|2|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/raphaelbarbosaqwerty/maestro-dev-skills --skill maestro-e2e
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maestro-e2e
Source: https://github.com/raphaelbarbosaqwerty/maestro-dev-skills/tree/main
Command: npx skills add https://github.com/raphaelbarbosaqwerty/maestro-dev-skills --skill maestro-e2e

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maestro E2E testing across iOS, Android, Flutter, React Native, and Web often requires coordinating disparate test definitions and environment configuration. This Skill provides a unified, YAML-driven framework to author, organize, and execute cross-platform end-to-end UI tests, reducing duplication and speeding debugging.

Core Features & Use Cases

  • Cross-platform coverage: automate E2E flows across iOS, Android, Flutter, React Native, and Web using a single skill unit.
  • YAML-first authoring: define apps, env, and subflows in a structured, human-readable format.
  • Modular subflows and parameterization: reuse flows with runFlow and env overrides to support different environments and users.
  • CI/CD readiness: guidelines for actions/ci integration and reproducible test pipelines.

Quick Start

Create a YAML flow directory under the skill and run maestro test e2e/ to execute all flows.

Frequently Asked Questions about maestro-e2e

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run cross-platform E2E tests for Flutter and React Native?

Cross-platform E2E tests for Flutter and React Native run from YAML definitions using the Maestro framework. You create a YAML flow directory and execute 'maestro test e2e/' to validate UI flows across iOS, Android, and Web.

Can I parameterize Maestro test flows with environment variables?

Yes, Maestro test flows support environment parameterization and environment variable overrides. This allows you to reuse modular subflows across different testing environments and user configurations defined in your YAML files.

What is the best way to organize reusable UI test steps in Maestro?

The best way to organize reusable UI test steps in Maestro is through modular subflows. You define these structured subflows in YAML and reference them via runFlow commands to reduce duplication across cross-platform end-to-end test suites.

Does Maestro E2E testing support CI/CD pipeline integration?

Yes, Maestro E2E testing supports CI/CD integration for reproducible test pipelines. The YAML-driven framework provides guidelines for actions and CI integration to automate cross-platform UI test execution during continuous integration workflows.

How do I debug failing end-to-end UI tests defined in YAML?

To debug failing end-to-end UI tests defined in YAML, use the structured Maestro test definitions to validate and isolate cross-platform flow failures. The framework handles setup and execution to help speed up debugging of E2E suites.

Why define E2E test flows in YAML instead of platform-specific code?

Defining E2E test flows in YAML provides a unified, human-readable format that reduces duplication across iOS, Android, Flutter, React Native, and Web. This avoids coordinating disparate test definitions and speeds up cross-platform debugging.