Registry / devops / esbuild-plugin-swc-minify

esbuild-plugin-swc-minify

library2.1.3jsnpmunverified

An esbuild plugin that replaces esbuild's default minifier (Terser) with SWC's minifier for faster minification of JavaScript and JSX files. Current stable version is 2.1.3, released March 2026 with a CVE fix. Active development with monthly releases. Key differentiators: leverages SWC's Rust-based minifier for 5-10x faster minification compared to Terser, supports all JSX/JS minification options via SWC's JsMinifyOptions, and integrates seamlessly as an esbuild plugin without requiring a separate build step. Requires esbuild >=0.20.0 and @swc/core >=1.13.3 as peer dependencies.

devops

npm install esbuild-plugin-swc-minify

github ↗package ↗

INSTALL

IMPORT

SIG · ESBUILD-PLUGIN-SWC

esbuild-plugin-swc-minify

devopsjavascriptv2.1.3

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.

swcMinify

✓ import { swcMinify } from 'esbuild-plugin-swc-minify'

✗ const { swcMinify } = require('esbuild-plugin-swc-minify')

ESM-only plugin; CommonJS require may fail in older Node.js versions. The package is ESM-only since v2.0.

default export

✓ import swcMinify from 'esbuild-plugin-swc-minify'

✗ const swcMinify = require('esbuild-plugin-swc-minify').default

No default export; only named export 'swcMinify' exists. Default import is incorrect and yields undefined.

swcMinify (as plugin)

✓ import { swcMinify } from 'esbuild-plugin-swc-minify'

✗ import swcMinify from 'esbuild-plugin-swc-minify'

Using default import instead of named import will result in undefined.

Demonstrates basic usage of esbuild-plugin-swc-minify with esbuild build, including plugin setup with SWC minification options.

import * as esbuild from 'esbuild'; import { swcMinify } from 'esbuild-plugin-swc-minify'; await esbuild.build({ entryPoints: ['./src/index.js'], outfile: 'dist/index.min.js', bundle: true, minify: true, sourceMap: true, plugins: [ swcMinify({ ecma: 2022 }) ] });

Debug

Known issues

gotchaDo not use both esbuild's built-in minification (minify: true) and swcMinify plugin together; they will conflict. The plugin is designed to replace the built-in minifier.

fix

Remove minify: true from esbuild options when using swcMinify plugin.

affects: >=1.0.0

breakingv2.0.0 dropped CommonJS support; the package is now ESM-only. Node.js must be configured for ES modules ("type": "module" in package.json or .mjs extension).

fix

Switch to ESM imports; replace require() with import statements.

affects: >=2.0.0 <3.0.0

deprecatedUsing @swc/core <1.13.3 is unsupported and may cause runtime errors.

fix

Upgrade @swc/core to >=1.13.3.

affects: >=2.0.0

gotchaThe plugin does not support minifying CSS; only JavaScript/JSX files are processed.

fix

Use a separate CSS minifier (e.g., esbuild's built-in CSS minifier or a plugin).

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'esbuild-plugin-swc-minify'

Missing or incorrect installation; package not installed or not in node_modules.

fix

Install the package: pnpm add -D esbuild-plugin-swc-minify (or npm).

TypeError: swcMinify is not a function

Using default import instead of named import, or incorrectly requiring the package.

fix

Use named import: import { swcMinify } from 'esbuild-plugin-swc-minify';

Error: @swc/core version must be >=1.13.3

Installed @swc/core version is too old for the current esbuild-plugin-swc-minify version.

fix

Upgrade @swc/core: pnpm add @swc/core@latest

Error: The plugin 'swcMinify' must be used with esbuild >=0.20.0

esbuild version below required peer dependency.

fix

Upgrade esbuild: pnpm add esbuild@latest

Upgrade

Version history

2.1.3latest on npm

Audit

Dependencies

@swc/corerequiredpeer dependency — SWC core library for minification

esbuildrequiredpeer dependency — esbuild build tool

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/D1g1talEntr0py/esbuild-plugin-swc-minify ↗

packagehttps://www.npmjs.com/package/esbuild-plugin-swc-minify ↗