# @web/dev-server

> Dev server for web applications

Latest version **1.0.0** (published 2026-07-07) · MIT license · 0 weekly downloads

## Install

```sh
npm install @web/dev-server
pnpm add @web/dev-server
yarn add @web/dev-server
bun add @web/dev-server
```

Provides the commands `wds`, `web-dev-server`.

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.0.0 |
| Published | 2026-07-07 |
| First published | 2020-07-14 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=22.0.0 |
| Dependencies | 14 |
| Unpacked size | 77.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 2452 |
| Author | modern-web |
| Maintainers | d4kmor, passle, jorenbroekema, bennyp, larsdenbakker, westbrook, modern-web |
| Keywords | web, dev, server, default, implementation, cli |

## Links

- npm: https://www.npmjs.com/package/@web/dev-server
- Repository: https://github.com/modernweb-dev/web
- Homepage: https://github.com/modernweb-dev/web/tree/master/packages/dev-server
- Issues: https://github.com/modernweb-dev/web/issues
- npm.io page: https://npm.io/package/@web/dev-server

## Dependencies (14)

- [open](https://npm.io/package/open.md) ^8.0.2
- [debounce](https://npm.io/package/debounce.md) ^1.2.0
- [camelcase](https://npm.io/package/camelcase.md) ^6.2.0
- [deepmerge](https://npm.io/package/deepmerge.md) ^4.2.2
- [nanocolors](https://npm.io/package/nanocolors.md) ^0.2.1
- [portfinder](https://npm.io/package/portfinder.md) ^1.0.32
- [internal-ip](https://npm.io/package/internal-ip.md) ^6.2.0
- [@babel/code-frame](https://npm.io/package/@babel/code-frame.md) ^7.12.11
- [command-line-args](https://npm.io/package/command-line-args.md) ^5.1.1
- [@web/config-loader](https://npm.io/package/@web/config-loader.md) ^1.0.0
- [command-line-usage](https://npm.io/package/command-line-usage.md) ^7.0.1
- [@web/dev-server-core](https://npm.io/package/@web/dev-server-core.md) ^1.0.0
- [@web/dev-server-rollup](https://npm.io/package/@web/dev-server-rollup.md) ^1.0.0
- [@types/command-line-args](https://npm.io/package/@types/command-line-args.md) ^5.0.0

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 1.0.0 (latest) — 2026-07-07
- 0.0.0-canary-20240219104536 (canary) — 2024-02-19
- 0.1.20-next.0 (next) — 2021-07-27
- 0.4.6 — 2024-06-26
- 0.4.5 — 2024-05-12
- 0.4.4 — 2024-04-04
- 0.4.3 — 2024-02-19
- 0.0.0-canary-20240219104126 — 2024-02-19
- 0.0.0-canary-20240212171943 — 2024-02-12
- 0.4.2 — 2024-01-30
- 0.0.0-canary-20240105101412 — 2024-01-05
- 0.0.0-canary-20240105095248 — 2024-01-05
- 0.0.0-canary-20240105093823 — 2024-01-05
- 0.0.0-canary-20240105092607 — 2024-01-05
- 0.0.0-canary-20240105091725 — 2024-01-05
- … 108 more at https://npm.io/package/@web/dev-server/versions

## README

# Web Dev Server

Dev Server for web applications, ideal for buildless es module workflows. Optionally supports simple code transformations.

- Efficient browser caching for fast reloads
- Transform code on older browsers for compatibility
- Resolve bare module imports for use in the browser (--node-resolve)
- Auto-reload on file changes with the (--watch)
- History API fallback for SPA routing (--app-index index.html)
- Plugin and middleware API for extensions
- Powered by [esbuild](/docs/dev-server/plugins/esbuild.md) and [rollup plugins](/docs/dev-server/plugins/rollup.md)

> Web Dev server is the successor of [es-dev-server](https://www.npmjs.com/package/es-dev-server)

See [our website](https://modern-web.dev/docs/dev-server/overview/) for full documentation.

## Installation

Install the dev server:

```
npm i --save-dev @web/dev-server
```

## Basic commands

Start the dev server:

```
web-dev-server --node-resolve --open
wds --node-resolve --open
```

Run in watch mode, reloading on file changes:

```
web-dev-server --node-resolve --watch --open
wds --node-resolve --watch --open
```

Use history API fallback for SPA routing:

```
web-dev-server --node-resolve --app-index demo/index.html --open
wds --node-resolve --app-index demo/index.html --open
```

Transform JS to a compatible syntax based on user agent:

```
web-dev-server --node-resolve --open --esbuild-target auto
wds --node-resolve --open --esbuild-target auto
```

## Example projects

Check out the <a href="https://github.com/modernweb-dev/example-projects" target="_blank" rel="noopener noreferrer">example projects</a> for a fully integrated setup.

## Documentation

See [our website](https://modern-web.dev/docs/dev-server/overview/) for full documentation.

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