Registry / devops / serverless-esbuild

serverless-esbuild

library1.57.1jsnpmunverified

Serverless Framework plugin for zero-config JavaScript and TypeScript bundling using esbuild. Current stable version is 1.57.1 (April 2026), released continuously with semantic release. It automatically bundles and minifies Lambda functions with esbuild, supports TypeScript and JavaScript, integrates with sls package/deploy/deploy function, serverless-offline, and invoke local. Key differentiator: zero-config, extremely fast (esbuild), and supports multiple providers (AWS, Google Cloud, etc.) with runtime support for Node.js 18+. Requires peer dependencies esbuild (0.8 - 0.28) and esbuild-node-externals (^1.0.0). Ships TypeScript types.

devops aws

npm install serverless-esbuild

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · SERVERLESS-ESBUILD

serverless-esbuild

devopsjavascriptv1.57.1

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

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

serverless-esbuild

✓ plugins: - serverless-esbuild

✗ plugins: - serverlessEsbuild

Plugin is loaded by name in serverless.yml. No import in JS code.

Minimal serverless.yml setup with a TypeScript handler bundled by serverless-esbuild.

// Install dependencies // npm install -D serverless-esbuild esbuild esbuild-node-externals // serverless.yml service: my-service provider: name: aws runtime: nodejs18.x plugins: - serverless-esbuild functions: hello: handler: src/handler.hello events: - http: path: hello method: get // src/handler.ts export const hello = async (event: any) => { return { statusCode: 200, body: JSON.stringify({ message: 'Hello from esbuild!' }), }; };

serverless --version

Debug

Known issues

breakingNode.js 18+ required

fix

Upgrade Node.js to version 18 or higher.

affects: >=1.54.0

breakingesbuild peer dependency range updated

fix

Ensure esbuild version is 0.8-0.28. For earlier versions, esbuild 0.8-0.25 is supported.

affects: >=1.56.0

breakingDropped Node.js 14 and 16 support

fix

Upgrade Node.js to 18+.

affects: >=1.54.0

gotchaMemory leak when skipRebuild is true

fix

Upgrade to 1.54.5+ which contains a fix for the memory leak.

affects: >=1.50.0 <1.54.5

gotchaAutomatic externalization of all node_modules via esbuild-node-externals

fix

To include specific node_modules in the bundle, add them to the 'external' option or override packager options.

affects: >=0?

Errors

Common errors & fixes

Error: Cannot find module 'esbuild'

esbuild not installed or not in node_modules

fix

npm install -D esbuild

Error: serverless-esbuild expects Node >= 18

Running on older Node.js version

fix

Upgrade Node.js to v18 or later

TypeError: Cannot read properties of undefined (reading 'includes')

esbuild version incompatible with serverless-esbuild

fix

Update esbuild to a supported version (0.8 - 0.28)

Upgrade

Version history

1.57.1latest on npm

Audit

Dependencies

esbuildrequiredcore bundler - peer dependency

esbuild-node-externalsrequiredautomatically externalize node_modules - peer dependency

Agent activity

14 hits · last 30 days

node

Resources

githubhttps://github.com/floydspace/serverless-esbuild ↗

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

homepagehttps://floydspace.github.io/serverless-esbuild ↗