![\"Astur\"](\"https://astur-mobile.github.io/Astur/brand/astur-logo.png\"){kind=logo}
\n \n\n \n \n \n
\n ![\"npm](\"https://img.shields.io/npm/v/@astur-mobile/test.svg?color=0A1730&label=npm\")
\n ![\"npm](\"https://img.shields.io/npm/dm/@astur-mobile/test.svg?color=24C6B7&label=downloads\")
\n ![\"license\"](\"https://img.shields.io/npm/l/@astur-mobile/test.svg?color=0A1730\")
\n
\n Documentation • \n Getting Started • \n Demo App • \n Inspector & Codegen\n
\n\n---\n\n**Astur** drives real Android and iOS apps through the platforms' own automation engines — Android UIAutomator (Kotlin) and Apple XCUITest (Swift) — exposed through a Playwright-style API. No Appium server, no WebDriver bridge. `@astur-mobile/test` is the **Playwright Test integration**: the `device` fixture, `expect`, locators, auto-waiting, projects, retries, and reporters you already know.\n\n```bash\nnpm install -D @astur-mobile/test astur-mobile @playwright/test\n```\n\n> `@playwright/test` is a peer dependency — Astur extends the Playwright Test runner, so your project provides it.\n\n```ts\nimport { test, expect } from '@astur-mobile/test';\n\ntest('login', async ({ device }) => {\n await device.getByLabel('Email').fill('qa@example.com');\n await device.getByRole('button', { name: 'Login' }).tap();\n await expect(device.getByText('Welcome')).toBeVisible();\n});\n```\n\nBecause Astur is built on Playwright Test, you can run specs with the CLI **or** straight from the **VS Code Playwright extension** (the green ▶ run button) — fixtures, projects, `expect`, retries, and reporters all work.\n\n## Runs where your app runs\n\n| Platform | Simulator / Emulator | Real device |\n| --- | :---: | :---: |\n| **Android** | ✅ | ✅ |\n| **iOS** | ✅ | ✅ |\n\nNative locators (`getByRole`, `getByLabel`, `getByText`, `getByTestId`), gestures (tap, double-tap, long-press, swipe, drag, scroll-into-view), forms, file upload, permissions, rotation, and hybrid **WebView** DOM control — all through one API.\n\n## Try it in 30 seconds\n\nA ready-to-run **[demo app](https://astur-mobile.github.io/Astur/demo-app/)** ships with the framework; each screen exercises one capability (tap, scroll, swipe, drag, forms, upload, WebView). Drive it through the Inspector without writing a test:\n\n```bash\n# Android emulator\nnpx astur-mobile codegen --android --device emulator-5554 \\\n --app ./assets/astur.demo.android.apk --app-id com.astur.demo\n\n# iOS simulator\nnpx astur-mobile codegen --ios --simulator \\\n --app ./assets/Astur.app --app-id com.astur.demo\n```\n\nOr clone the **[astur-boilerplate](https://github.com/Astur-mobile/astur-boilerplate)** starter for full Android and iOS suites.\n\n## Resources\n\n- 📖 **[Documentation](https://astur-mobile.github.io/Astur/)** — guides, configuration, and platform notes\n- 🚀 **[Getting Started](https://astur-mobile.github.io/Astur/getting-started/)** — install and run your first test\n- 🔎 **[Inspector & Codegen](https://astur-mobile.github.io/Astur/inspector/)** — stream a device, inspect locators, record flows, export specs\n- 📱 **[Demo App](https://astur-mobile.github.io/Astur/demo-app/)** — a tour of every automation capability\n- 🧩 **[astur-boilerplate](https://github.com/Astur-mobile/astur-boilerplate)** — clone-and-run example suites\n\n## Sponsor\n\nAstur is open source and built in the open. If it saves your team time, consider supporting development:\n\n\n ![\"Support](\"https://img.shields.io/badge/Ko--fi-Support%20Astur-FF5E5B?logo=kofi&logoColor=white\"){kind=icon}
![\"Sponsor](\"https://img.shields.io/badge/GitHub-Sponsor-EA4AAA?logo=githubsponsors&logoColor=white\"){kind=icon}