Mobilewright

Mobilewright is a TypeScript/JavaScript automation framework for iOS and Android, inspired by Playwright's architecture and API. Full documentation is at mobilewright.dev/docs.

This page covers how to connect Mobilewright to Mobile Next Cloud to run your scripts and tests against real cloud devices instead of local simulators.

Connect to Mobile Next Cloud

Mobilewright uses a driver config option to target cloud devices. When MOBILENEXT_API_KEY is set, add a driver block to your mobilewright.config.ts:

import { defineConfig, type MobilewrightConfig } from 'mobilewright';

const config: MobilewrightConfig = {
  platform: 'ios',
  bundleId: 'com.example.myapp',
  // ...rest of your config
};

if (process.env['MOBILENEXT_API_KEY']) {
  config.driver = {
    type: 'mobilenext',
    apiKey: process.env['MOBILENEXT_API_KEY'],
  };
}

export default defineConfig(config);

When MOBILENEXT_API_KEY is not set, Mobilewright falls back to a local device via mobilecli. This lets you run the same config locally and in CI without any code changes.

Test result metadata

The driver config accepts an optional testResult block to label runs in the Mobile Next Cloud dashboard:

config.driver = {
  type: 'mobilenext',
  apiKey: process.env['MOBILENEXT_API_KEY'],
  testResult: {
    name: 'Smoke suite',
    tags: ['nightly'],
    environment: 'production',
  },
};

Get an API key

Get your API key at app.mobilenext.ai. See Mobile Next Cloud for device allocation and account setup.