{"id":26342,"library":"rsbuild-plugin-html-minifier-terser","title":"Rsbuild Plugin HTML Minifier Terser","description":"An Rsbuild plugin that integrates html-minifier-terser to minify HTML outputs during the build process. Current stable version is 1.1.3. Released under MIT license. It provides a seamless way to optimize HTML files generated by Rsbuild, supporting customization of minification options either as an object or a callback function. Unlike other HTML minification plugins, it respects Rsbuild's JavaScript minification settings. It requires @rsbuild/core v1 or v2 (peer dependency) and ships TypeScript type definitions.","status":"active","version":"1.1.3","language":"javascript","source_language":"en","source_url":"https://github.com/rstackjs/rsbuild-plugin-html-minifier-terser","tags":["javascript","typescript"],"install":[{"cmd":"npm install rsbuild-plugin-html-minifier-terser","lang":"bash","label":"npm"},{"cmd":"yarn add rsbuild-plugin-html-minifier-terser","lang":"bash","label":"yarn"},{"cmd":"pnpm add rsbuild-plugin-html-minifier-terser","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency: plugin requires Rsbuild to apply the minifier","package":"@rsbuild/core","optional":false}],"imports":[{"note":"The package exports a named function, not a default export. TypeScript types are included.","wrong":"import pluginHtmlMinifierTerser from 'rsbuild-plugin-html-minifier-terser'","symbol":"pluginHtmlMinifierTerser","correct":"import { pluginHtmlMinifierTerser } from 'rsbuild-plugin-html-minifier-terser'"},{"note":"CJS requires destructuring; direct require returns an object.","wrong":"const pluginHtmlMinifierTerser = require('rsbuild-plugin-html-minifier-terser')","symbol":"pluginHtmlMinifierTerser","correct":"const { pluginHtmlMinifierTerser } = require('rsbuild-plugin-html-minifier-terser')"},{"note":"No subpath exports; always import from the package root.","wrong":"import { pluginHtmlMinifierTerser } from 'rsbuild-plugin-html-minifier-terser/plugin'","symbol":"pluginHtmlMinifierTerser","correct":"import { pluginHtmlMinifierTerser } from 'rsbuild-plugin-html-minifier-terser'"}],"quickstart":{"code":"// rsbuild.config.ts\nimport { pluginHtmlMinifierTerser } from 'rsbuild-plugin-html-minifier-terser';\n\nexport default {\n  plugins: [\n    pluginHtmlMinifierTerser(),\n  ],\n};","lang":"typescript","description":"Add the plugin to Rsbuild config. HTML output will be minified with default html-minifier-terser options."},"warnings":[{"fix":"Ensure your project uses @rsbuild/core@^1.0.0 || ^2.0.0-0","message":"Requires @rsbuild/core v1 or v2 as peer dependency; incompatible with other versions.","severity":"breaking","affected_versions":">=0.0.0"},{"fix":"Use a callback to customize options based on defaults: pluginHtmlMinifierTerser((options) => { options.minifyCSS = false; return options; })","message":"The plugin accepts an options object or callback; passing a non-function object is fine, but if you need to modify default options, you must use a function.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"If you need full control, pass minifyJS, minifyCSS options to the plugin.","message":"This plugin only minifies HTML; JavaScript and CSS minification inside HTML is controlled by Rsbuild's built-in minifiers unless specified via html-minifier-terser options.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"N/A","message":"No deprecations yet; plugin is actively maintained.","severity":"deprecated","affected_versions":">=0.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"npm add rsbuild-plugin-html-minifier-terser -D","cause":"Package not installed or incorrect import path","error":"Cannot find module 'rsbuild-plugin-html-minifier-terser'"},{"fix":"Use import { pluginHtmlMinifierTerser } from 'rsbuild-plugin-html-minifier-terser'","cause":"Using default import instead of named import","error":"TypeError: pluginHtmlMinifierTerser is not a function"},{"fix":"npm add @rsbuild/core -D (ensure version ^1.0.0 || ^2.0.0-0)","cause":"Missing peer dependency","error":"Error: Cannot find module '@rsbuild/core'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}