{"id":25275,"library":"esbuild-deploy","title":"esbuild-deploy","description":"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.","status":"active","version":"1.0.1","language":"javascript","source_language":"en","source_url":"https://github.com/atopala/esbuild-deploy","tags":["javascript","typescript"],"install":[{"cmd":"npm install esbuild-deploy","lang":"bash","label":"npm"},{"cmd":"yarn add esbuild-deploy","lang":"bash","label":"yarn"},{"cmd":"pnpm add esbuild-deploy","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"The package is primarily used as a CLI tool. No JavaScript API is exposed.","wrong":"node node_modules/.bin/esbuild-deploy","symbol":"esbuild-deploy (CLI)","correct":"npx esbuild-deploy"}],"quickstart":{"code":"{\n  \"scripts\": {\n    \"build\": \"esbuild-deploy\"\n  }\n}\n// Run: npm run build\n// Output goes to ./deploy (configurable via --outdir)","lang":"javascript","description":"Shows how to add esbuild-deploy as a build script and run it."},"warnings":[{"fix":"Update Node.js to >=20.19.2.","message":"Requires Node.js >=20.19.2 — older versions will fail to install or run.","severity":"gotcha","affected_versions":"<20.19.2"},{"fix":"Run tsc separately before esbuild-deploy for TypeScript projects.","message":"Does not perform TypeScript type checking; only transpilation via esbuild. Type errors won't be caught during bundling.","severity":"gotcha","affected_versions":"*"},{"fix":"Update to v1.0.0 and adjust package.json fields if needed.","message":"Breaking 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.","severity":"breaking","affected_versions":"<1.0.0"},{"fix":"Use -o or --outdir to specify a different output directory.","message":"The --outdir default is './deploy' — this directory will be overwritten each run. Ensure you don't have important files there.","severity":"gotcha","affected_versions":"*"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Install as devDependency: npm install --save-dev esbuild-deploy","cause":"Package not installed globally or not in node_modules.","error":"Error: Cannot find module 'esbuild-deploy'"},{"fix":"Upgrade Node.js to >=20.19.2.","cause":"Node.js version is too old.","error":"Error: esbuild-deploy requires Node.js version >=20.19.2"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}