Overview
MobileWright is a modern open-source mobile test automation framework built as the ‘Playwright for Mobile’. It provides a unified and developer-friendly way to automate both iOS and Android applications across real devices and emulators with near zero setup complexity.
Why MobileWright
Traditional tools like Appium require complex setup involving servers, drivers, and platform-specific configurations. MobileWright eliminates this overhead through a simple npm-based installation and a Playwright-like API that developers already understand.
Key Benefits
- Playwright-style API (getByRole, getByLabel, expect)
- Zero configuration setup
- Cross-platform support (iOS & Android)
- Built-in auto-waiting for stable execution
- AI-agent first architecture
- Cloud-ready with real device integration
Quick Start & Installation
Prerequisites:
- Node.js >= 18
- iOS simulator / Android emulator / real device
- Xcode or Android SDK
Installation Commands:
npm install mobilewright @mobilewright/test
Verification:
npx mobilewright doctor
Configuration
MobileWright uses a clean configuration model:
- platform: ios | android
- deviceName: Example (iPhone 16)
- timeout and retries supported
- testDir and file patterns
- reporter support (html, json, junit)
Locator Strategies
MobileWright provides powerful element locators:
- getByLabel – accessibility labels
- getByRole – semantic roles
- getByText – visible text
- getByTestId – accessibility id
- getByType – UI element type
AI Agent Integration
MobileWright is designed for AI-native automation:
- Exposes accessibility tree for LLM understanding
- Eliminates screenshot-based parsing
- Works with tools like Copilot, Claude, Cursor
- Integrates with MCP servers for mobile automation
- Enables deterministic and token-efficient execution
Cloud Device Support
MobileWright integrates with cloud platforms to run tests on real devices at scale without changing scripts.
Proof of Concept (POC)
Two POC scenarios were successfully executed using MobileWright:
1. Rapido App – Metro Flow
- Automated navigation and validation of Metro booking flow
- Demonstrated stable execution with auto-waiting
- Execution logs confirmed successful test runs
2. Rapido App – Parcel Flow
- Automated parcel booking flow
- Showcased element detection and interaction consistency
- Demonstrated reliability across UI interactions
Example Usage
Below command is used across POC scenarios:
npm install mobilewright @mobilewright/test
Demo & Reference
Official Website: https://mobilewright.dev/
Refer to attached POC recordings and screenshots for execution proof and practical demonstration.
MobileWright -mobilewright.dev/
Example – Rapido App-Metro
npm install mobilewright @mobilewright/test
Example – Rapido App-Parcel
npm install mobilewright @mobilewright/test
Reference link – https://mobilewright.dev/
