Example app used by the Percy JS Appium tutorial and Percy JS WebdriverIO tutorial demonstrating App Percy's JS Appium and WebdriverIO integrations.
New: This repo ships
advanced/examples for both drivers covering the full applicable App Percy SDK feature surface for@percy/appium-app. See the Percy SDK Feature Matrix for cross-SDK coverage.
| Driver | Example | What it shows | Run command |
|---|---|---|---|
| webdriverio | webdriverio/android/ (basic) |
Minimum viable: one percyScreenshot(name) call per test. |
cd webdriverio && npm run android |
| webdriverio | webdriverio/advanced/ |
Full applicable App Percy SDK feature surface — wdio + mocha + 9 it() blocks per matrix row. See webdriverio/advanced/README.md. |
cd webdriverio/advanced && npm install && npx percy app:exec -- npm run test:advanced |
| wd | wd/android.js (basic) |
Minimum viable: one percyScreenshot(driver, name) call per test. |
cd wd && node android.js |
| wd | wd/advanced/ |
Same matrix-row coverage as webdriverio/advanced/ via a sequential wd promise-chain script (advanced.js). See wd/advanced/README.md. |
cd wd/advanced && npm install && npx percy app:exec -- npm run test:advanced |
The tutorial assumes you're already familiar with JavaScript and the Appium wd/webdriverio framework. You'll still be able to follow along if you're not familiar with Appium concepts, but we won't spend time introducing JS Appium concepts.
This tutorial also assumes you have Node 14+ with npm and git installed.
Depending on which framework you use for testing, please follow the tutorial in either wd directory or webdriverio directory.