Introduction to Mobilewright

Learn what Mobilewright is, why it makes mobile app testing simple, and how it compares to Appium and Maestro.

What Is Mobilewright?

Mobilewright is an open-source end-to-end testing framework for mobile applications. It gives you one simple API to automate both iOS and Android apps — on simulators, emulators, and real devices. If you have ever used Playwright for web testing, Mobilewright will feel instantly familiar: the same test and expect functions, the same locator style, and the same auto-waiting philosophy — just pointed at a mobile app instead of a browser.

Here is what makes it stand out:

Cross-platform — one test can run on both iOS and Android. Auto-waiting — no manual waits or sleeps, ever. TypeScript-first — full type safety and autocompletion, and plain JavaScript works too. Agent-ready — built with AI agent integration in mind.

How Does It Compare?

Appium has been the standard for mobile automation for years, but it needs drivers, capabilities objects, and lots of setup. Maestro is simple but uses YAML flows instead of a real programming language. Mobilewright gives you the best of both worlds: a modern, code-first API that is easy to read and quick to set up.

A Taste of Mobilewright

This is a complete, working Mobilewright test. It launches your app, waits for the welcome text, and passes when it appears. Notice there is no driver setup, no capabilities object, and no sleep statement anywhere.

import { test, expect } from '@mobilewright/test';

test('app launches and shows home screen', async ({ screen }) => {
  // The screen fixture is your window into the device
  await expect(screen.getByText('Welcome')).toBeVisible();
});

const { test, expect } = require('@mobilewright/test');

test('app launches and shows home screen', async ({ screen }) => {
  // The screen fixture is your window into the device
  await expect(screen.getByText('Welcome')).toBeVisible();
});

That is the whole test. The screen fixture connects to the device, launches the app defined in your config, and the assertion keeps retrying until the text shows up (or times out). In the next chapter we will install Mobilewright and get this running on your machine.