npm.io
10.1.0 • Published 2 weeks ago

create-wdio

Licence
MIT
Version
10.1.0
Deps
0
Vulns
0
Weekly
0
Stars
9.9K

WebdriverIO Starter Toolkit PRs Welcome

Logo

One command to create a fresh WebdriverIO project or add WebdriverIO to an existing project.

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.

Example

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 as devDependencies (default: true)
  • --yes - Will fill in all config defaults without prompting (default: false)
  • --npm-tag - use a specific NPM tag for @wdio/cli package (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.

Keywords