Playwright-style API
Use a Playwright-style TypeScript API to locate elements by role, label, or text, then chain actions and assertions in familiar code.
Mobilewright
Mobilewright is a TypeScript mobile automation framework for iOS and Android apps, with Playwright-style locators, auto-waiting, and local reporting.
Overview
Mobilewright is an end-to-end testing framework for mobile applications. It provides a TypeScript API for automating iOS and Android devices with a Playwright-style interaction model, built-in auto-waiting, assertions, and test reporting.
The product is positioned for developers and AI agents who need deterministic mobile automation for testing and scripting. Its examples show support for simulators, emulators, and real devices, with integrations around the platform accessibility tree and a CLI that can initialize projects, run tests, and generate reports.
Features
Auto-waiting and actionability checks
Actions and assertions retry until elements exist, are visible, enabled, and stable, reducing the need for manual waits or sleeps.
Cross-platform mobile automation
Run the same test flow across iOS and Android, including simulators, emulators, and real devices, from one API.
Zero-config project scaffolding
Set up projects with `npm init mobilewright@latest`, which creates a config file and example test, and use the CLI to run or inspect tests.
Agent-ready debugging and selection
Inspect the accessibility tree and attach it on failure so agents and debugging tools can work with roles, labels, and values instead of screenshots alone.
Local reporting and diagnostics
Use the HTML reporter to view test results locally, filter runs, inspect errors, and review screenshots from the browser.
Use Cases
End-to-end app testing
Write mobile end-to-end tests in TypeScript using familiar locators and assertions when you want test code that is readable and reviewable.
Workflow scripting
Automate repetitive in-app flows, such as sign-in, onboarding, or checkout, with auto-waiting actions that reduce the need for manual pauses.
Cross-platform validation
Run the same test logic across iOS and Android devices, including simulators, emulators, and physical hardware, when you need cross-platform coverage.
Agent-assisted automation
Use the accessibility tree and failure-time view tree to help AI agents or debugging tools interact with real UI elements instead of guessing from screenshots.
Test review and debugging
Generate local HTML reports to inspect failures, screenshots, and error details after a test run.
Pros and Cons
Pros
- TypeScript-first API with autocompletion and full type safety.
- Auto-waiting and retrying assertions reduce manual synchronization.
- Supports both iOS and Android from a single API.
- Can run on real devices as well as simulators and emulators.
- Includes a local HTML test report for review and debugging.
Cons
- The pricing page was unavailable in the collected sources, so plan details are not confirmed here.
- The available comparison pages highlight limitations of Appium and Maestro, but the source set here does not document every supported workflow or edge case for Mobilewright itself.
FAQ
What is Mobilewright used for?
Mobilewright is a TypeScript-based end-to-end testing framework for mobile apps. It uses a Playwright-style API so you can automate iOS and Android devices with role-, label-, and text-based locators, auto-waiting actions, and retrying assertions.
Which platforms and app types does it support?
The docs describe support for iOS and Android, including simulators, emulators, and real devices. The site also notes support for UIKit, SwiftUI, React Native, and Expo in examples.
How do you get started with Mobilewright?
Installation is npm-based: install the package, run `npm init mobilewright@latest` to scaffold a project, then use `npx mobilewright test` to run tests. The framework also includes `npx mobilewright doctor` for environment checks and `npx mobilewright show-report` for HTML reports.
Is Mobilewright suitable for AI agent workflows?
Yes. The comparison pages describe Mobilewright as built for AI agents, with access to the platform accessibility tree and optional view-tree attachment on failure for debugging. The homepage also positions it for developers and AI agents.
Does Mobilewright have pricing information on the site?
The source does not show published pricing. The pricing URL currently returns a missing-file error, so the site content available here does not support specific plan details.
Quick Facts
- Category
- Mobile automation / test framework
- Platform
- iOS and Android
- Primary users
- Developers and AI agents
- API style
- TypeScript with Playwright-style locators
- Install
- npm package (`mobilewright` and `@mobilewright/test`)
Mobilewright Alternatives
EAS Observe
EAS Observe monitors production performance in Expo and React Native apps, showing startup metrics, session timelines, release markers, and errors in the Expo dashboard.
ByteAsk
ByteAsk is a terminal-first AI coding agent for C and C++ that edits repos and verifies changes with compilers, debuggers, sanitizers, and tests.
CreateOS Sandbox
CreateOS Sandbox is an isolated compute environment for running code and agent workloads in Firecracker micro-VMs with private networking and SDK, CLI, or MCP control.
GitBot
GitBot is a local browser workspace for reusable coding bots powered by Claude Code, Codex, or OpenCode, with persistent threads and configurable permissions.
Codex Plugins
Codex Plugins bundle reusable skills, app integrations, and MCP servers into workflows you can install in the Codex app or use from Codex CLI.
Wallie
Wallie is an open-source AI streamer that watches your screen, hears chat, and delivers live commentary in a configurable persona. Runs locally with your own keys.