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 like page.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/test extends Playwright Test with screen and device fixtures

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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/mobile-nextmobilewright.svg)](https://yunodb.com/tools/mobile-nextmobilewright?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/mobile-nextmobilewright?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/mobile-nextmobilewright.svg" alt="Featured on YunoDB" height="20"></a>