Registry / devops / esbuild-hexo-minifier

esbuild-hexo-minifier

library0.1.7jsnpmunverified

A Hexo plugin that minifies static assets (HTML, CSS, JS, images, fonts) using esbuild. Version 0.1.7, stable with occasional updates. Differentiates from other Hexo minifiers by leveraging esbuild's speed for JS/CSS minification, but has known issues with some configurations and lacks comprehensive documentation.

devops

npm install esbuild-hexo-minifier

package ↗

INSTALL

IMPORT

SIG · ESBUILD-HEXO-MINIF

esbuild-hexo-minifier

devopsjavascriptv0.1.7

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-hexo-minifier (CLI)

✓ npx esbuild-hexo-minifier

✗ require('esbuild-hexo-minifier')

This package provides a CLI command, not a JavaScript API. Use npx or global install to run as a script.

package.json script

✓ "build": "hexo generate && esbuild-hexo-minifier"

✗ "build": "hexo generate && node esbuild-hexo-minifier"

Run via npm script after hexo generate; do not attempt to require it in Node.js code.

default export (no API)

✓ No import needed; rely on CLI.

✗ import minifier from 'esbuild-hexo-minifier'

This package has no programmatic API; only CLI usage is supported.

Installs the package as a dev dependency, adds a build script that runs hexo generate then the minifier, and executes it.

npm install esbuild-hexo-minifier --save-dev # Add to package.json scripts: "scripts": { "build": "hexo generate && esbuild-hexo-minifier" } npm run build

Debug

Known issues

gotchaMinifier may break custom Hexo scripts or generate unexpected output if asset paths contain special characters.

fix

Review output assets and manually verify minification; consider using quotes in configuration if paths have spaces.

affects: <0.2.0

deprecatedGlobal installation is discouraged; use npx or local dev dependency instead.

fix

Install locally with --save-dev and run via npx or npm script.

affects: all

gotchaNo configuration options: the minifier applies default settings without customization.

fix

If customization is needed, consider alternative Hexo minifier plugins like hexo-all-minifier.

affects: all

gotchaNon-JS assets (images, fonts) are minified using default esbuild loaders which may produce larger files or unsupported formats.

fix

Disable image/font minification by not adding those file types, or use dedicated tools like gulp-imagemin.

affects: 0.1.x

breakingIn version 0.1.5, the CLI name changed from 'esbuild-hexo-minifier' to 'esbuild-hexo-minifier' (same name, but script invocation changed).

fix

Run 'npx esbuild-hexo-minifier' instead of previous script name if upgrading from below 0.1.5.

affects: 0.1.5

Errors

Common errors & fixes

esbuild-hexo-minifier: command not found

Package not installed or not in PATH.

fix

Install locally: npm install esbuild-hexo-minifier --save-dev, then use npx esbuild-hexo-minifier or define script in package.json.

Error: Cannot find module 'esbuild'

esbuild peer dependency not installed.

fix

Run npm install esbuild --save-dev to install esbuild alongside the minifier.

hexo generate && esbuild-hexo-minifier throws 'Permission denied'

Global installation requires superuser privileges; local installation does not.

fix

Avoid global install; use local dev dependency and run via npm script.

Minified file is larger than original (images or fonts)

Default esbuild minification for binary assets may increase size due to encoding.

fix

Skip image/font minification by not including those file types in the processed assets, or use dedicated image minification tools.

Upgrade

Version history

0.1.7latest on npm

Audit

Dependencies

esbuildrequiredCore minification engine for JS and CSS files.

Agent activity

2 hits · last 30 days

node

Resources

packagehttps://www.npmjs.com/package/esbuild-hexo-minifier ↗