Dioxus Service

@wdio/dioxus-service is a 3rd party package, for more information please see GitHub | npm

WebdriverIO service for testing Dioxus desktop applications on Windows, Linux, and macOS.

Enables cross-platform E2E testing of Dioxus apps via the extensive WebdriverIO ecosystem.

Features

• 🚗 WebDriver server built into your app — no separate driver to install on any platform
• 📦 Automatic Dioxus binary path detection
• 🌐 Cross-platform support (Windows, Linux, macOS)
• 🔗 Full Dioxus API access via browser.dioxus.execute()
• 🧩 Mocking support for Dioxus invoke commands
• 📊 Backend and frontend log capture
• 🖥️ Multiremote testing support
• 🏃 Per-worker driver spawning for parallel testing
• 🌍 Browser mode — test the Dioxus frontend in plain Chrome against a dev server, no binary or driver required

Installation

Install the service via npm:

npm install --save-dev @wdio/dioxus-service

Or with pnpm:

pnpm add -D @wdio/dioxus-service

Quick Start

Get started in minutes with the Quick Start Guide.

Minimal Configuration

Add to your wdio.conf.ts:

export const config = {
  services: ['@wdio/dioxus-service'],

  capabilities: [
    {
      browserName: 'dioxus',
      'dioxus:options': {
        // Debug build from `dx build --desktop` (Linux path; see the Quick Start for macOS and Windows)
        application: './target/dx/my-app/debug/linux/app/my-app',
      },
    },
  ],
};

See Configuration Reference for all options.

Documentation

Getting Started

• Quick Start Guide - Set up in minutes
• App Setup - Add wdio-dioxus to your app

Reference

• Configuration - All service options
• API Reference - Complete API documentation

Guides

• Browser Mode - Test the renderer in Chrome without a Dioxus binary
• Usage Examples - Common testing patterns
• Log Forwarding - Capture app logs
• Deeplink Testing - Test protocol handlers

Help & Support

• Troubleshooting - Common issues and solutions
• Development - Contributing guide

Platform Support

Platform	Supported
Windows	✅ Yes
Linux	✅ Yes
macOS	✅ Yes

The WebDriver server runs inside your app, so there's no driver to install. The Quick Start lists each platform's requirements.

Example Projects

Check out the E2E test fixtures in the desktop-mobile repository for complete working examples.

Support

Having trouble? Here are some resources:

1. Troubleshooting Guide - Solutions for common issues
2. GitHub Issues - Bug reports and feature requests
3. WebdriverIO Forum - General community help and discussions

Contributing

We welcome contributions! Please see our Development Guide for:

• Setting up your development environment
• Running tests
• Code style guidelines
• Pull request process

Quick start for contributors:

# Clone and install
git clone https://github.com/webdriverio/desktop-mobile.git
cd desktop-mobile
pnpm install

# Make your changes
# ...

# Run tests
pnpm test

# Submit a pull request

License

MIT License. See LICENSE file for details.

See Also

• WebdriverIO Documentation
• Dioxus Documentation
• @wdio/tauri-service - Similar service for Tauri apps
• @wdio/electron-service - Similar service for Electron apps