One TypeScript API. One test spec. Web and native Android.

CrossPlay is an open source cross-platform test automation framework: write a user flow once and run it against your web app (Chromium, Firefox, WebKit — Playwright-backed) and your native Android app (UIAutomator2-backed, no Appium server), with Playwright-quality auto-waiting, unified selectors, and a portable trace for every run.

ℹ️ Status: public release. Stable API and documentation are now live — see the npm badge above for the current version. See the quickstart guide to begin.

Teams with a web + mobile product maintain two test stacks today: Playwright/Cypress for web, Appium/Maestro for mobile. Same login flow, written twice, maintained twice. Appium covers platforms with poor DX; Playwright has great DX but no native mobile. CrossPlay exists to close that gap.

import { test, by, expect } from '@projectcrossplay/core/test';

test('login flow', async ({ app }) => {
  await app.fill(by.testId('username'), 'demo');
  await app.fill(by.testId('password'), 's3cret');
  await app.tap(by.testId('login-button'));
  expect(await app.getText(by.testId('welcome'))).toContain('Welcome');
});

crossplay test --target=all   # same spec: Chromium + Firefox + WebKit + Android emulator/device

• Auto-waiting on mobile at web quality — every action waits for present, visible, stable, enabled; no sleeps, ever
• Unified selectors — by.testId(...) maps to data-testid on web and resource-id/content-desc on Android
• Trace everything — per-step screenshots, action log, failure hierarchy; crossplay show-trace opens a local viewer
• 15-minute onboarding — crossplay init scaffolds, crossplay doctor diagnoses your environment
• Extensible by design — drivers implement one documented PlatformDriver interface; core never changes. iOS is the first planned driver after v0.1

The spikes/ directory holds the validation spikes behind the architecture decisions — including live-measured UIAutomator2 session startup of 1.57s (results).

• Quickstart — a passing test in under 15 minutes
• Onboarding Demo — a complete, standalone example project with a step-by-step walkthrough to get you started quickly
• Selectors — by.testId/by.text/by.role, and what each maps to per platform
• Architecture — how the pieces fit together
• Writing a driver — implement PlatformDriver for another platform
• API reference — generated from types

pnpm install
pnpm build && pnpm typecheck && pnpm test

Node 20.19+, 22.12+, or 24+ (matches the appium-uiautomator2-server dependency's range). The examples/demo-android-rn app is a standalone React Native project with its own, stricter requirement (Node ≥ 22.11) inherited from the RN template — it isn't part of the pnpm workspace and doesn't affect the range above. See CONTRIBUTING.md. Security policy: SECURITY.md.

Apache 2.0