mobile-e2e-maestro

Automates end-to-end UI testing of iOS and Android apps using Maestro CLI flows.

16|1|Updated May 5, 2026
One-click install
npx skills add https://github.com/AIBiz-Automatyzacje/workspace-template-mobile --skill mobile-e2e-maestro-aibiz-automatyzacje
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mobile-e2e-maestro
Source: https://github.com/AIBiz-Automatyzacje/workspace-template-mobile/tree/main/.claude/skills/mobile-e2e-maestro
Command: npx skills add https://github.com/AIBiz-Automatyzacje/workspace-template-mobile --skill mobile-e2e-maestro-aibiz-automatyzacje

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually verifying mobile app behavior on emulators is slow and error-prone, and in-process testing tools cannot exercise real OS-level flows like deep links and OAuth redirects. This Skill automates end-to-end UI testing of built iOS/Android apps through Maestro CLI, driving taps, swipes, input, assertions, and screenshots against what the user actually sees. ## Core Features & Use Cases - YAML Flow Automation: Write declarative test flows covering navigation, taps, gestures (swipe, long press), text input, assertions, waits, and screenshots, then run them with maestro test. - Deep Linking & OAuth Testing: Simulate OAuth callbacks and push-notification links via openLink, which routes through the real OS router — something in-process test frameworks cannot do. - Native OS Boundary Handling: Guidance for surfaces Maestro cannot touch (photo pickers, native alerts, biometrics), with a service_role data-injection pattern via GraalJS runScript scripts and [Manual] fallback steps. - Use Case: During a feature review, convert each verification checklist item into a .maestro/<feature>-<scenario>.yaml flow, run it against a dedicated E2E Supabase project, and report pass/fail per checkbox with screenshots. ## Quick Start Ask the assistant to write a Maestro flow that launches the app, logs in with the test account, asserts the welcome screen appears, and captures a screenshot.

Frequently Asked Questions about mobile-e2e-maestro

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

FAQPage Schema
How do I write a Maestro test flow for a mobile app?

Create a YAML file in a .maestro/ folder with your appId, then list steps like launchApp, tapOn, inputText, and assertVisible. Run it with maestro test .maestro/your-flow.yaml against a built app on a running emulator or simulator.

How to test OAuth deep link flows in mobile E2E tests?

Use Maestro's openLink command to simulate the OAuth redirect, for example openLink with myapp://auth/callback?code=mock-code. Maestro routes the link through the real OS router via simctl or adb, which in-process testing frameworks cannot replicate.

Can Maestro interact with native photo pickers or system alerts?

No, Maestro only controls elements in your app's accessibility tree, not native OS surfaces like photo pickers, camera, native alerts, or biometric prompts. Inject test data directly via a service_role REST script and assert the rendered result, or mark those steps as manual.

Why does my Maestro runScript fail to read files from disk?

Maestro runScript executes in GraalJS, not Node, so there is no filesystem access, require, or Node modules. Pass binary data inline as a string or base64 in the request body, and pass secrets via maestro test -e flags or MAESTRO_ prefixed environment variables.

Does Maestro work with Expo dev builds and hot reload?

Maestro does not work on dev builds with hot reload enabled. Build a release or preview build with eas build --profile preview, install it on the emulator, and run your flows against that binary.