mobilewright
Mobilewright is a dev framework for Mobile App Testing and Automation. It allows testing iOS/Android app on real devices, emulators and simulators with a single
What is mobilewright?
Mobilewright is a dev framework for Mobile App Testing and Automation. It allows testing iOS/Android app on real devices, emulators and simulators with a single API.
Overview of mobilewright
What it is
Mobilewright is a dev framework for Mobile App Testing and Automation. It allows testing iOS/Android app on real devices, emulators and simulators with a single API. It is inspired by Playwright's architecture and developer experience.
Key features
- Playwright-style API —
screen.getByRole('button').tap(), just likepage.getByRole('button').click() - Zero config — auto-discovers booted simulators - Cross-platform — unified interface for iOS and Android - Auto-waiting — actions wait for elements to be visible, enabled, and stable before interacting - Chainable locators —
screen.getByType('Cell').getByLabel('Item 1') - Retry assertions —
expect(locator).toBeVisible()polls until satisfied or timeout - Remote support — connect to mobilecli on another machine for device lab setups - Test fixtures —@mobilewright/testextends Playwright Test withscreenanddevicefixtures
Use cases
- Testing iOS and Android apps on real devices, emulators, and simulators - AI agent control of mobile devices via accessibility tree (no vision model needed)
- Integration with mobile-mcp, Claude, Cursor, or any coding agent - Device lab setups with remote mobilecli connections
Getting started
bash npm install mobilewright @mobilewright/test npx mobilewright init typescript import { test, expect } from '@mobilewright/test'; test('can sign in', async ({ screen }) => { await screen.getByLabel('Email').fill('[email protected]'); await screen.getByLabel('Password').fill('password123'); await screen.getByRole('button', { name: 'Sign In' }).tap(); await expect(screen.getByText('Welcome back')).toBeVisible(); }); bash npx mobilewright test
License and pricing
License: Apache-2.0. Pricing: open source (free).
Based on the project's public README and repository metadata.