compression-rspack-plugin

Rust-native parallel compression plugin for Rspack. Drop-in replacement for compression-webpack-plugin.

Compresses assets in parallel across all CPU cores via Rust + rayon, instead of serially on the Node.js main thread.

Install

npm install compression-rspack-plugin
# or
pnpm add compression-rspack-plugin
# or
yarn add compression-rspack-plugin

Prebuilt binaries are available for macOS (arm64, x64), Linux (x64 glibc, arm64 glibc, x64 musl). The correct binary is installed automatically via platform-specific optional dependencies.

Usage

import { CompressionRspackPlugin } from 'compression-rspack-plugin'

export default {
  plugins: [
    new CompressionRspackPlugin({ test: /\.(js|css|html|json|svg)$/ }),
    new CompressionRspackPlugin({ algorithm: 'brotliCompress', test: /\.(js|css|html|json|svg)$/ }),
  ],
}

Options

Same interface as compression-webpack-plugin. Validated via schema-utils.

Option	Type	Default	Description
algorithm	string | Function	"gzip"	"gzip", "brotliCompress", "deflate", "deflateRaw", or custom callback
compressionOptions	object	{}	Passed to the algorithm. Defaults to max quality per algorithm.
filename	string | Function	"[path][base].gz"	Output template. "[path][base].br" for brotli.
test	RegExp | string | Array	—	Include matching assets
include	RegExp | string | Array	—	Include matching assets
exclude	RegExp | string | Array	—	Exclude matching assets
threshold	number	0	Min size in bytes
minRatio	number	0.8	Only emit if compressed/original < this
deleteOriginalAssets	boolean | "keep-source-map" | Function	false	Remove originals after compression

Benchmarks

Tested on a production Rspack build (~1,400 assets, Apple M3 Pro 14-core).

	compression-webpack-plugin	compression-rspack-plugin
Build time (avg of 3)	82.7s	37.3s (2.2x faster)
Compression phase (RsDoctor)	61.1s	20.3s (3.0x faster)
.gz files	1,410	1,411
.br files	1,444	1,444
gzip-6 / 1 KB	106 MiB/s	143 MiB/s (1.4x)
gzip-6 / 100 KB	0.66 GiB/s	2.77 GiB/s (4.2x)
gzip-6 / 1 MB	0.66 GiB/s	3.30 GiB/s (5.0x)
deflate-6 / 1 MB	0.69 GiB/s	2.03 GiB/s (2.9x)

How it works

Built-in algorithms (gzip, brotliCompress, deflate, deflateRaw) are handled by flate2 and brotli in Rust via a single napi-rs FFI call. Custom algorithms fall back to Node.js zlib.

Differences from compression-webpack-plugin

	compression-webpack-plugin	compression-rspack-plugin
Compression	Node.js zlib (serial)	Rust rayon (parallel) + zlib fallback
Compilation cache	Yes	Not yet
Child compilations	Yes (scoped via thisCompilation)	Yes
[compressed] stats flag	Yes	Registered, not rendered by rspack 2.0 beta

Development

pnpm install        # install deps
pnpm build          # native addon + TypeScript
pnpm test           # JS tests (120 tests)
pnpm test:rust      # Rust unit tests
pnpm lint           # biome
pnpm lint:rs        # cargo fmt + clippy
pnpm typecheck      # tsc --noEmit

License

MIT