esbuild-deploy

library1.0.1jsnpmunverified

esbuild-deploy is a zero-config CLI tool that bundles Node.js applications for deployment using esbuild, eliminating the need to ship node_modules. It automatically detects ESM or CJS module systems from package.json fields (type, main, module), and produces minimal bundles in a deploy/ directory. Version 1.0.1 is the latest stable release, with types included. Key differentiators: automatic esbuild configuration, no manual setup, and compatibility injection for ESM/CJS interop. Part of a beta-then-1.0 transition with several beta releases prior.

devops

npm install esbuild-deploy

github ↗package ↗

INSTALL

IMPORT

SIG · ESBUILD-DEPLOY

esbuild-deploy

devopsjavascriptv1.0.1

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.

esbuild-deploy (CLI)

✓ npx esbuild-deploy

✗ node node_modules/.bin/esbuild-deploy

The package is primarily used as a CLI tool. No JavaScript API is exposed.

Shows how to add esbuild-deploy as a build script and run it.

{ "scripts": { "build": "esbuild-deploy" } } // Run: npm run build // Output goes to ./deploy (configurable via --outdir)

esbuild-deploy --version

Debug

Known issues

gotchaRequires Node.js >=20.19.2 — older versions will fail to install or run.

fix

Update Node.js to >=20.19.2.

affects: <20.19.2

gotchaDoes not perform TypeScript type checking; only transpilation via esbuild. Type errors won't be caught during bundling.

fix

Run tsc separately before esbuild-deploy for TypeScript projects.

affects: *

breakingBreaking change from beta: in v1.0.0-beta.x the entry point detection logic differed. Ensure your package.json has 'type', 'main', or 'module' properly set.

fix

Update to v1.0.0 and adjust package.json fields if needed.

affects: <1.0.0

gotchaThe --outdir default is './deploy' — this directory will be overwritten each run. Ensure you don't have important files there.

fix

Use -o or --outdir to specify a different output directory.

affects: *

Errors

Common errors & fixes

Error: Cannot find module 'esbuild-deploy'

Package not installed globally or not in node_modules.

fix

Install as devDependency: npm install --save-dev esbuild-deploy

Error: esbuild-deploy requires Node.js version >=20.19.2

Node.js version is too old.

fix

Upgrade Node.js to >=20.19.2.

Upgrade

Version history

1.0.1latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/atopala/esbuild-deploy ↗

packagehttps://www.npmjs.com/package/esbuild-deploy ↗