maestro-capture

What problem does it solve?

Capturing consistent screenshots from an iOS Simulator and manually comparing them to design prototypes is time-consuming and error-prone, especially when navigation requires scripted flows and temporary automation artifacts.

Core Features & Use Cases

• Automates validating the simulator state and verifying the app is running before capture.
• Generates temporary Maestro navigation flows to reach target screens, runs Maestro to navigate, and captures high-fidelity simulator screenshots.
• Optionally reads a matching prototype PNG from the design folder and provides a structured gap analysis covering layout differences, missing elements, and style mismatches.
• Use case: QA engineers or mobile developers verifying the "settings" or "inbox" screens of a React Native app running in Expo across design handoff.

Quick Start

Use the maestro-capture skill to capture the named section from the iOS simulator and optionally compare it to the prototype image using the --compare flag.