# Mobilewright

> Reliable mobile automation framework for testing, scripting, and AI agents, powered by Playwright with a single deterministic API for iOS and Android.

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.*

## Features
- Playwright-style API for mobile automation
- iOS and Android support via one unified API
- Auto-waiting and retry assertions
- Chainable locators (getByLabel, getByRole, getByText)
- Supports UIKit, SwiftUI, React Native, and Expo
- Zero-config CLI with auto-discovery of simulators
- Scaffold, run, and verify environment from CLI
- Cloud-ready with real device support via Mobile Use
- AI agent automation support
- Apache 2.0 open-source license

## Integrations
Mobile Use, iOS Simulator, Android Emulator, React Native, Expo, UIKit, SwiftUI, npm

## Platforms
ANDROID, IOS, WEB, API, DEVELOPER_SDK, CLI

## Pricing
Open Source

## Links
- Website: https://mobilewright.dev
- Documentation: https://mobilewright.dev/docs
- Repository: https://github.com/mobile-next/mobilewright
- EveryDev.ai: https://www.everydev.ai/tools/mobilewright