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.