{"id":25286,"library":"esbuild-hexo-minifier","title":"esbuild-hexo-minifier","description":"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.","status":"active","version":"0.1.7","language":"javascript","source_language":"en","source_url":null,"tags":["javascript"],"install":[{"cmd":"npm install esbuild-hexo-minifier","lang":"bash","label":"npm"},{"cmd":"yarn add esbuild-hexo-minifier","lang":"bash","label":"yarn"},{"cmd":"pnpm add esbuild-hexo-minifier","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core minification engine for JS and CSS files.","package":"esbuild","optional":false}],"imports":[{"note":"This package provides a CLI command, not a JavaScript API. Use npx or global install to run as a script.","wrong":"require('esbuild-hexo-minifier')","symbol":"esbuild-hexo-minifier (CLI)","correct":"npx esbuild-hexo-minifier"},{"note":"Run via npm script after hexo generate; do not attempt to require it in Node.js code.","wrong":"\"build\": \"hexo generate && node esbuild-hexo-minifier\"","symbol":"package.json script","correct":"\"build\": \"hexo generate && esbuild-hexo-minifier\""},{"note":"This package has no programmatic API; only CLI usage is supported.","wrong":"import minifier from 'esbuild-hexo-minifier'","symbol":"default export (no API)","correct":"No import needed; rely on CLI."}],"quickstart":{"code":"npm install esbuild-hexo-minifier --save-dev\n# Add to package.json scripts:\n\"scripts\": {\n  \"build\": \"hexo generate && esbuild-hexo-minifier\"\n}\nnpm run build","lang":"javascript","description":"Installs the package as a dev dependency, adds a build script that runs hexo generate then the minifier, and executes it."},"warnings":[{"fix":"Review output assets and manually verify minification; consider using quotes in configuration if paths have spaces.","message":"Minifier may break custom Hexo scripts or generate unexpected output if asset paths contain special characters.","severity":"gotcha","affected_versions":"<0.2.0"},{"fix":"Install locally with --save-dev and run via npx or npm script.","message":"Global installation is discouraged; use npx or local dev dependency instead.","severity":"deprecated","affected_versions":"all"},{"fix":"If customization is needed, consider alternative Hexo minifier plugins like hexo-all-minifier.","message":"No configuration options: the minifier applies default settings without customization.","severity":"gotcha","affected_versions":"all"},{"fix":"Disable image/font minification by not adding those file types, or use dedicated tools like gulp-imagemin.","message":"Non-JS assets (images, fonts) are minified using default esbuild loaders which may produce larger files or unsupported formats.","severity":"gotcha","affected_versions":"0.1.x"},{"fix":"Run 'npx esbuild-hexo-minifier' instead of previous script name if upgrading from below 0.1.5.","message":"In version 0.1.5, the CLI name changed from 'esbuild-hexo-minifier' to 'esbuild-hexo-minifier' (same name, but script invocation changed).","severity":"breaking","affected_versions":"0.1.5"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Install locally: npm install esbuild-hexo-minifier --save-dev, then use npx esbuild-hexo-minifier or define script in package.json.","cause":"Package not installed or not in PATH.","error":"esbuild-hexo-minifier: command not found"},{"fix":"Run npm install esbuild --save-dev to install esbuild alongside the minifier.","cause":"esbuild peer dependency not installed.","error":"Error: Cannot find module 'esbuild'"},{"fix":"Avoid global install; use local dev dependency and run via npm script.","cause":"Global installation requires superuser privileges; local installation does not.","error":"hexo generate && esbuild-hexo-minifier throws 'Permission denied'"},{"fix":"Skip image/font minification by not including those file types in the processed assets, or use dedicated image minification tools.","cause":"Default esbuild minification for binary assets may increase size due to encoding.","error":"Minified file is larger than original (images or fonts)"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}