WebdriverIO Starter Toolkit 
One command to create a fresh WebdriverIO project or add WebdriverIO to an existing project.
- Get Started Guide - How to get started with WebdriverIO
- Supported Options - command line parameters
create-wdio works on macOS, Windows, and Linux.
If something doesn’t work, please file an issue.
If you have questions or need help, please ask in our Discord Support channel.
Usage
To install a WebdriverIO project, you may choose one of the following methods:
npx
npx create-wdio@latest ./e2e
npx is a package runner tool that comes with npm 5.2+ and higher, see instructions for older npm versions
npm
npm init wdio@latest ./e2e
npm init <initializer> is available in npm 6+
yarn
yarn create wdio@latest ./e2e
yarn create <starter-kit-package> is available in Yarn 0.25+
pnpm
pnpm create wdio ./e2e
pnpm create <starter-kit-package> is available in pnpm v7+
It will create a directory called e2e inside the current folder.
Then it will run the configuration wizard that will help you set-up your framework.
Supported Options
You can pass the following command line flags to modify the bootstrap mechanism:
--dev- Install all packages asdevDependencies(default:true)--yes- Will fill in all config defaults without prompting (default:false)--npm-tag- use a specific NPM tag for@wdio/clipackage (default:latest)
Every question of the configuration wizard also has a flag, e.g. --runner, --framework, --typescript, --browsers, --reporters or --services. A flag answers its question and the wizard only asks the rest. Combined with --yes the setup runs without any prompt, e.g. for a coding agent or a CI job:
npm init wdio@latest ./e2e -- --yes --framework cucumber --no-typescript --reporters spec,junit
Run npm init wdio@latest -- --help for every flag and the values it accepts. Boolean flags take a --no- prefix. An invalid value, or a flag for a question that does not apply to your setup, exits with code 2.
For more information on WebdriverIO see the homepage.