wdio-healix-service

A self-healing WebdriverIO service that turns live web & mobile apps into durable, standalone test suites — authored by observing the real UI, maintained automatically, and run with zero AI at runtime.

npm i -D wdio-healix-service
# or scaffold a whole project:  npx create-healix my-app

The model

• Two-file page objects — structure + actions in .page.ts (decorated @Find / @FindAll fields, no selectors); selectors live in a sibling .locators.json with per-platform web / ios / android keys. A selector fix is a JSON edit, never a code change.
• testSuite() / testCase() — stateful, ordered tests that chain from one browser state to the next.
• Self-healing — a locator that doesn't resolve pauses the test (the session stays alive) instead of failing; resolve it and the test resumes in place.
• takeScreenshot(name) — report-integrated capture: saves to reports/screenshots/ and attaches to Allure. Never hardcode screenshot paths.
• Multi-platform — web (WebDriver) and native Android / iOS (Appium), plus built-in OCR for screens with no DOM.

Use

// wdio.conf.ts
services: [['healix', { api: { enabled: true } }]]

// test/specs/login.spec.ts
import { testSuite, testCase, takeScreenshot } from 'wdio-healix-service';

testSuite('Login', () => {
  testCase('signs in', async () => {
    // drive observed @Find fields from your page objects
    await takeScreenshot('after-login');
  });
});

Pairs with healix-mcp to let an AI agent author and heal the suite for you. The result always runs on its own: npx wdio run — no AI, no MCP.