Skip to content

Add WebdriverIO 9 Mobile Automation Boilerplate with Appium#15035

Merged
christian-bromann merged 2 commits intowebdriverio:mainfrom
syamphaneendra:patch-3
Jan 23, 2026
Merged

Add WebdriverIO 9 Mobile Automation Boilerplate with Appium#15035
christian-bromann merged 2 commits intowebdriverio:mainfrom
syamphaneendra:patch-3

Conversation

@syamphaneendra
Copy link
Contributor

Summary

Adding a new mobile test automation boilerplate for WebdriverIO 9 with Appium support for Android and iOS platforms.

What's included

This boilerplate provides a production-ready mobile testing framework with:

  • WebdriverIO v9 + Cucumber v9 + TypeScript v5 + Appium v2.5
  • Multi-platform support: Android (UiAutomator2) and iOS (XCUITest)
  • Page Object Model pattern for maintainable test structure
  • Mobile gestures: Scroll, swipe, long press, keyboard interactions
  • App-to-Web navigation: Context switching and WebView support
  • Comprehensive reporting: Allure reports with screenshots, Spec reporter, Winston logger
  • Test management: Tag-based execution, retry mechanism, parallel execution
  • Fresh app state: Automatic app reset between scenarios
  • CI/CD ready: GitHub Actions, GitLab CI, Docker support

Key Features

✅ TypeScript with strict type checking
✅ Centralized device and environment configuration ✅ Reusable utilities (gestures, context switcher, logger) ✅ Screenshot on failure with Allure integration
✅ Cross-platform support (macOS, Linux, Windows)
✅ Modular architecture with separation of concerns

Repository

https://github.com/syamphaneendra/webdriverio9-boilerplate

Documentation

Complete setup instructions, usage examples, and known issues documented in README.md

Proposed changes

Types of changes

  • Polish (an improvement for an existing feature)
  • Bugfix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update (improvements to the project's docs)
  • Specification changes (updates to WebDriver command specifications)
  • Internal updates (everything related to internal scripts, governance documentation and CI files)

Checklist

  • I have read the CONTRIBUTING doc
  • I have added tests that prove my fix is effective or that my feature works
  • I have added the necessary documentation (if appropriate)
  • I have added proper type definitions for new commands (if appropriate)

Backport Request

//: # (The current main branch is the development branch for WebdriverIO v9. If your change should be released to the current major version of WebdriverIO (v8), please raise another PR with the same changes against the v8 branch.)

  • This change is solely for v9 and doesn't need to be back-ported
  • Back-ported PR at #XXXXX

Further comments

Reviewers: @webdriverio/project-committers

## Summary
Adding a new mobile test automation boilerplate for WebdriverIO 9 with Appium support for Android and iOS platforms.

## What's included
This boilerplate provides a production-ready mobile testing framework with:
- **WebdriverIO v9** + **Cucumber v9** + **TypeScript v5** + **Appium v2.5**
- **Multi-platform support**: Android (UiAutomator2) and iOS (XCUITest)
- **Page Object Model** pattern for maintainable test structure
- **Mobile gestures**: Scroll, swipe, long press, keyboard interactions
- **App-to-Web navigation**: Context switching and WebView support
- **Comprehensive reporting**: Allure reports with screenshots, Spec reporter, Winston logger
- **Test management**: Tag-based execution, retry mechanism, parallel execution
- **Fresh app state**: Automatic app reset between scenarios
- **CI/CD ready**: GitHub Actions, GitLab CI, Docker support

## Key Features
✅ TypeScript with strict type checking
✅ Centralized device and environment configuration
✅ Reusable utilities (gestures, context switcher, logger)
✅ Screenshot on failure with Allure integration
✅ Cross-platform support (macOS, Linux, Windows)
✅ Modular architecture with separation of concerns

## Repository
https://github.com/syamphaneendra/webdriverio9-boilerplate

## Documentation
Complete setup instructions, usage examples, and known issues documented in README.md
@pkg-pr-new
Copy link

pkg-pr-new bot commented Jan 19, 2026

Open in StackBlitz

create-wdio

npm i https://pkg.pr.new/webdriverio/webdriverio/create-wdio@15035

eslint-plugin-wdio

npm i https://pkg.pr.new/webdriverio/webdriverio/eslint-plugin-wdio@15035

@wdio/allure-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/allure-reporter@15035

@wdio/appium-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/appium-service@15035

@wdio/browser-runner

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/browser-runner@15035

@wdio/browserstack-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/browserstack-service@15035

@wdio/cli

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/cli@15035

@wdio/concise-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/concise-reporter@15035

@wdio/config

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/config@15035

@wdio/cucumber-framework

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/cucumber-framework@15035

@wdio/dot-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/dot-reporter@15035

@wdio/firefox-profile-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/firefox-profile-service@15035

@wdio/globals

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/globals@15035

@wdio/jasmine-framework

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/jasmine-framework@15035

@wdio/json-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/json-reporter@15035

@wdio/junit-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/junit-reporter@15035

@wdio/lighthouse-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/lighthouse-service@15035

@wdio/local-runner

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/local-runner@15035

@wdio/logger

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/logger@15035

@wdio/mocha-framework

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/mocha-framework@15035

@wdio/protocols

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/protocols@15035

@wdio/repl

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/repl@15035

@wdio/reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/reporter@15035

@wdio/runner

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/runner@15035

@wdio/sauce-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/sauce-service@15035

@wdio/shared-store-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/shared-store-service@15035

@wdio/smoke-test-cjs-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/smoke-test-cjs-service@15035

@wdio/smoke-test-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/smoke-test-reporter@15035

@wdio/smoke-test-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/smoke-test-service@15035

@wdio/spec-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/spec-reporter@15035

@wdio/static-server-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/static-server-service@15035

@wdio/sumologic-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/sumologic-reporter@15035

@wdio/testingbot-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/testingbot-service@15035

@wdio/types

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/types@15035

@wdio/utils

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/utils@15035

@wdio/webdriver-mock-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/webdriver-mock-service@15035

@wdio/xvfb

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/xvfb@15035

webdriver

npm i https://pkg.pr.new/webdriverio/webdriverio/webdriver@15035

webdriverio

npm i https://pkg.pr.new/webdriverio/webdriverio@15035

commit: 48b45f5

Copy link
Member

@christian-bromann christian-bromann left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

@christian-bromann christian-bromann merged commit ea0e3e0 into webdriverio:main Jan 23, 2026
6 checks passed
@christian-bromann christian-bromann added the PR: Docs 📝 PRs that contain changes to the documentation label Jan 23, 2026
@wdio-bot
Copy link
Contributor

Hey syamphaneendra 👋

Thank you for your contribution to WebdriverIO! Your pull request has been marked as an "Expensable" contribution.

We've sent you an email with further instructions on how to claim your expenses from our development fund.
Please make sure to check your spam folder as well. If you have any questions, feel free to reach out to us at expense@webdriver.io or in the contributing channel on Discord.

We are looking forward to more contributions from you in the future 🙌

Have a nice day,
The WebdriverIO Team 🤖

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Expensable $15 💸 PR: Docs 📝 PRs that contain changes to the documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants