Installation
Taqwright puts Playwright's test runner on top of Appium 3, so you write mobile E2E tests the same way you'd write a Playwright web test, but you drive a real phone instead of a browser. This page takes you from nothing installed to a configured project ready to run its first test.
Writing tests
Taqwright tests perform actions on a live mobile device and assert the resulting UI state. Each test gets a fresh WebDriver session against your configured emulator, simulator, or physical device. Locators auto-wait for elements to be visible and actionable before driving them, so tests stay reliable even when the app animates.
Generating tests
Don't hand-write locators, pick them. The taqwright inspector is a browser-based device viewer that ranks candidate selectors against the live screen, and codegen is the same inspector with recording on, emitting a runnable spec as you drive the app.
Running & debugging
When a test fails on a device you can't see, you need a record of what happened. Taqwright captures two kinds, a per-action trace and a full-run video, writes them under the output directory, and hands everything to Playwright's reporters.
Custom reporters
Taqwright has no reporting layer of its own, it forwards the reporter option straight to Playwright's runner. So any Playwright reporter works unchanged, including a fully custom one you write. And because taqwright's device trace and screen recording are attached as standard Playwright attachments, your custom reporter can pull them into whatever report format you want.
Parallel runs
Taqwright is serial by default, one Appium, one device. To go parallel you either declare a local device pool and raise workers, or point at a cloud provider where each worker is its own independent session.
Run in Docker
Skip the local toolchain install, the repo's Docker setup bundles Node 24, Appium 3, JDK 21, the Android SDK command-line tools, and the UiAutomator2 driver into one image. Useful for CI (reproducible runs against a cloud device) and onboarding (contributors who don't want to install Appium / Android Studio locally).