Mobilewright

Mobilewright is an open-source mobile automation framework built by Mobile Next HQ, inspired by Playwright's API design. It provides a single deterministic API for iOS and Android, supporting auto-waiting, chainable locators, and retry assertions. The framework works with UIKit, SwiftUI, React Native, and Expo, and is cloud-ready for use with real devices via Mobile Use.

• Playwright-style SDK — Install via npm install mobilewright and use familiar chainable locators like screen.getByLabel(), screen.getByRole(), and expect().toBeVisible() for reliable mobile test authoring.
• iOS & Android support — One unified API targets both platforms, eliminating the need for separate automation stacks.
• Framework compatibility — Supports UIKit, SwiftUI, React Native, and Expo out of the box.
• Auto-waiting & retry assertions — Built-in waiting and assertion retries reduce flaky tests without manual sleep calls.
• Mobilewright CLI — Run npx mobilewright init to scaffold a project, npx mobilewright test to execute tests, and npx mobilewright doctor to verify your environment — zero config required.
• Auto-discovery of simulators — The CLI automatically detects available iOS simulators and Android emulators.
• Cloud-ready — Integrates with Mobile Use for running tests on real devices in the cloud.
• AI agent support — Designed to work as an automation layer for AI agents, enabling programmatic mobile interaction.
• Apache 2.0 licensed — Fully open-source under the Apache license, with source code available on GitHub.