WebdriverIO Desktop & Mobile Testing

WebdriverIO services for automated testing of native desktop and mobile applications

---

Features | Quick Start | Contribute | Changelog

Supported Services

@wdio/electron-service

Electron applications (Windows/macOS/Linux)
CDP bridge for main process • Full API mocking • Window management

@wdio/tauri-service

Tauri applications (Windows/Linux)
Official tauri-driver integration • Multiremote support • Plugin architecture

Planned Services

• Dioxus - Modern cross-platform UI framework
• React Native - Popular mobile and desktop framework
• Flutter - Google's UI toolkit for mobile and beyond
• Capacitor - Ionic's cross-platform mobile framework
• Neutralino - Lightweight desktop applications

See ROADMAP.md for detailed sequencing, platform support, and timelines.

Features

• 🎯 Framework-specific automation - Native integration with Electron, Tauri
• 🔍 Smart binary detection - Automatic app discovery and configuration
• 🎭 API mocking & isolation - Built-in mocking for deterministic tests
• 🌐 Cross-platform support - Write once, test everywhere
• 🔧 Consistent API - Familiar WDIO patterns across all frameworks

Quick Start

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run tests
pnpm test

# Run linting
pnpm lint

Project Structure

desktop-mobile/
├── packages/                    # Service packages
│   ├── electron-service/        # Electron service implementation
│   ├── tauri-service/           # Tauri service implementation
│   ├── electron-cdp-bridge/     # Chrome DevTools Protocol bridge
│   ├── native-utils/            # Cross-platform utilities
│   ├── native-types/            # TypeScript type definitions
│   ├── bundler/                 # Build tool for packaging
│   └── tauri-plugin/            # Tauri plugin for backend access
├── fixtures/                   # Test fixtures and example apps
│   ├── e2e-apps/               # E2E test applications
│   ├── package-tests/          # Package integration tests
│   └── config-formats/         # Configuration format test fixtures
├── e2e/                        # End-to-end test suites
│   ├── test/                   # Test specifications
│   │   ├── electron/           # Electron E2E tests
│   │   └── tauri/              # Tauri E2E tests
│   └── scripts/                # Test execution scripts
├── docs/                       # Documentation
└── scripts/                    # Build and utility scripts

Development

Requirements

• Node.js 18 LTS or 20 LTS
• pnpm 10.27.0+

Setup

pnpm install  # Install dependencies
pnpm build    # Build all packages
pnpm test     # Run tests

See docs/setup.md for detailed setup instructions and CONTRIBUTING.md for the full command reference.

Contributing

We welcome contributions! Please see CONTRIBUTING.md for detailed guidelines.

Architecture

Monorepo built with Turborepo, pnpm workspaces, and TypeScript. Each service integrates with WebdriverIO's test runner and provides framework-specific automation capabilities.

See docs/package-structure.md for package conventions and structure.

License

MIT License - see LICENSE for details.

Maintenance Policy

Note: This repository does not maintain LTS or backport branches. Only the latest version on main receives updates. See MAINTENANCE.md for details.

Community & Support

• WebdriverIO - Main WebdriverIO project
• WebdriverIO Docs - Official documentation
• WebdriverIO Community - Community resources
• Discord - Join the WebdriverIO Discord for support
• GitHub Issues - Bug reports and feature requests
• GitHub Discussions - Questions and ideas

Related Projects

• wdio-electron-service - Legacy Electron service repo
• tauri-driver - Official Tauri WebDriver implementation