# create-wdio

> Install and setup a WebdriverIO project with all its dependencies in a single run

Latest version **9.31.6** (published 2026-09-06) · MIT license · 0 weekly downloads

## Install

```sh
npm install create-wdio
pnpm add create-wdio
yarn add create-wdio
bun add create-wdio
```

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 9.31.6 |
| Published | 2026-09-06 |
| First published | 2021-11-03 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 9834 |
| Author | WebdriverIO Team |
| Maintainers | wdio-user |
| Keywords | webdriverio, create-wdio, wdio, installer, e2e |

## Links

- npm: https://www.npmjs.com/package/create-wdio
- Repository: https://github.com/webdriverio/webdriverio
- Homepage: https://github.com/webdriverio/webdriverio/tree/main/packages/create-wdio
- Issues: https://github.com/webdriverio/webdriverio/issues
- npm.io page: https://npm.io/package/create-wdio

## Alternatives

- [@snazzah/davey](https://npm.io/package/@snazzah/davey.md) — 1.5M weekly downloads
- [@vendure/testing](https://npm.io/package/@vendure/testing.md) — 8.3K weekly downloads
- [vue-simple-context-menu](https://npm.io/package/vue-simple-context-menu.md) — 6.6K weekly downloads
- [cypress-webpack-preprocessor-v5](https://npm.io/package/cypress-webpack-preprocessor-v5.md) — 2.1K weekly downloads
- [@backstage/plugin-catalog-backend-module-puppetdb](https://npm.io/package/@backstage/plugin-catalog-backend-module-puppetdb.md) — 1.3K weekly downloads

## Recent versions

- 9.31.6 (latest) — 2026-09-06
- 9.32.0-alpha.14 (next) — 2026-09-13
- 9.32.0-alpha.13 — 2026-09-13
- 9.32.0-alpha.6 — 2026-09-13
- 9.32.0-alpha.0 — 2026-09-13
- 9.32.0-alpha.3 — 2026-09-13
- 9.31.2 — 2026-08-21
- 9.30.1 — 2026-08-03
- 9.30.0 — 2026-07-21
- 9.29.1 — 2026-06-26
- 9.29.0 — 2026-06-18
- 9.28.0 — 2026-06-10
- 9.27.2 — 2026-05-26
- 9.27.1 — 2026-04-30
- 9.27.0 — 2026-03-23
- … 42 more at https://npm.io/package/create-wdio/versions

## README

WebdriverIO Starter Toolkit [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-green.svg)](https://github.com/webdriverio/webdriverio/blob/main/CONTRIBUTING.md)
===========================

<img alt="Logo" align="right" src="https://webdriver.io/assets/images/robot-3677788dd63849c56aa5cb3f332b12d5.svg" width="20%" />

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

- [Get Started Guide](https://webdriver.io/docs/gettingstarted) - How to get started with WebdriverIO
- [Supported Options](#supported-options) - command line parameters

`create-wdio` works on macOS, Windows, and Linux.<br>
If something doesn’t work, please [file an issue](https://github.com/webdriverio/webdriverio/issues/new).<br>
If you have questions or need help, please ask in our [Discord Support channel](https://discord.webdriver.io).

<p align="center">
    <img src="https://raw.githubusercontent.com/webdriverio/webdriverio/main/packages/create-wdio/assets/demo.gif" alt="Example" />
</p>

## Usage

To install a WebdriverIO project, you may choose one of the following methods:

#### npx

```sh
npx create-wdio@latest ./e2e
```

_[`npx`](https://medium.com/@maybekatz/introducing-npx-an-npm-package-runner-55f7d4bd282b) is a package runner tool that comes with npm 5.2+ and higher, see [instructions for older npm versions](https://gist.github.com/gaearon/4064d3c23a77c74a3614c498a8bb1c5f)_

#### npm

```sh
npm init wdio@latest ./e2e
```

_[`npm init <initializer>`](https://docs.npmjs.com/cli/v10/commands/npm-init) is available in npm 6+_

#### yarn

```sh
yarn create wdio@latest ./e2e
```

_[`yarn create <starter-kit-package>`](https://yarnpkg.com/lang/en/docs/cli/create/) is available in Yarn 0.25+_

#### pnpm

```sh
pnpm create wdio ./e2e
```

_[`pnpm create <starter-kit-package>`](https://pnpm.io/cli/create) 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`)

----

For more information on WebdriverIO see the [homepage](https://webdriver.io).

---
_Source: https://npm.io/package/create-wdio · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._