wds

library0.24.2jsnpmunverified

A fast reloading dev server for server-side TypeScript projects, version 0.24.2. Uses swc for on-demand compilation via ESM loaders and require.extensions. Prioritizes fast reboot over type checking, recommending out-of-band type checking. Key differentiators: incremental rebuilds in --watch mode, ESM and CJS support, monorepo awareness, disk caching, and IPC support. Inspired by ts-node-dev and tsx but with a focus on speed and simplicity. Maintained by Gadget Inc., with active releases.

web-framework devops

npm install wds

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · WDS

wds

web-frameworkjavascriptv0.24.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

wds

✓ npx wds script.ts

✗ Using require('wds') or import wds from 'wds'

wds is a CLI tool, not a library. Do not import it programmatically.

config

✓ // wds.js file in project root module.exports = { extensions: ['.ts', '.tsx'] }

✗ import config from 'wds' or using .wdsrc

Configuration is done via wds.js file exporting an object, not via package.json or direct imports.

types

✓ npx wds --help

✗ import { WdsOptions } from 'wds'

TypeScript types are for internal use; use CLI flags for usage.

Runs a TypeScript server in watch mode, restarting on file changes.

npx wds@0.24.2 --watch server.ts

wds --version

Debug

Known issues

gotchawds does NOT type-check your code. Rely on editor or CI for type checks.

fix

Run tsc --noEmit separately in CI or use editor integration.

affects: >=0.0.0

breakingESM-only from v0.21.0 onwards. CJS projects must upgrade or pin older version.

fix

Ensure package.json has 'type': 'module' or use .mjs extensions.

affects: >=0.21.0

gotchaThe --supervise flag will restart the process indefinitely even on non-code exit (e.g., process.exit(0)).

fix

Use --watch for file change restarts unless you need process supervision.

affects: >=0.0.0

deprecatedOld configuration via .swcrc is now secondary; wds.js is the primary config file.

fix

Migrate config to wds.js file per documentation.

affects: >=0.20.0

Errors

Common errors & fixes

Error: Cannot find module 'typescript'

wds does not require TypeScript as a peer dependency, but some projects expect it.

fix

Install TypeScript: npm install --save-dev typescript

TypeError: The 'superCtor' argument must be of type function.

Attempting to import/require wds as a module.

fix

Use wds as a CLI tool: npx wds ...

wds: command not found

wds is not installed globally or in PATH.

fix

Run npx wds or install with npm install -g wds

Upgrade

Version history

0.24.2latest on npm

Audit

Dependencies

@swc/corerequiredCore compiler backend for TypeScript/JS transformation.

chokidarrequiredFile watching for --watch mode.

Agent activity

11 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/gadget-inc/wds ↗

packagehttps://www.npmjs.com/package/wds ↗

homepagehttps://gadget.com ↗