#output.minify

• Type:

type Minify =
  | boolean
  | {
      js?: boolean;
      jsOptions?: Rspack.SwcJsMinimizerRspackPluginOptions;
      css?: boolean;
      cssOptions?: Rspack.LightningcssMinimizerRspackPluginOptions;
    };

• Default: true

Configure whether to enable code minification in production mode, or to configure minimizer options.

By default, JS and CSS code will be automatically minimized in production mode to improve page performance. If you do not want to minify the code, you can set minify to false to disable minification for all code. Alternatively, you can control the behavior of code minification through detailed configuration of the minify option. Below are detailed explanations for each configuration option:

#Example

#Disable minification

Set minify to false to disable JS and CSS code minification:

export default {
  output: {
    minify: false,
  },
};

#Options

#minify.js

• Type: boolean
• Default: mode === 'production'

Whether to enable minification for JavaScript code.

For example, disable JavaScript minification:

export default {
  output: {
    minify: {
      js: false,
    },
  },
};

#minify.jsOptions

• Type: Rspack.SwcJsMinimizerRspackPluginOptions
• Default: {}

output.minify.jsOptions is used to configure SWC's minification options. For detailed configurations, please refer to SwcJsMinimizerRspackPlugin. The following configuration will override the default settings, disable the mangle feature.

For example, disable the mangle feature:

export default {
  output: {
    minify: {
      jsOptions: {
        minimizerOptions: {
          mangle: false,
        },
      },
    },
  },
};

Refer to Configure SWC for more details.

#minify.css

• Type: boolean
• Default: mode === 'production'

Whether to enable minification for CSS code.

For example, disable CSS minification:

export default {
  output: {
    minify: {
      css: false,
    },
  },
};

#minify.cssOptions

• Type: Rspack.LightningcssMinimizerRspackPluginOptions
• Default: inherit from tools.lightningcssLoader

output.minify.cssOptions is used to configure Lightning CSS's minification options. For specific configuration items, please refer to LightningCssMinimizerRspackPlugin Documentation.

For example, disable error recovery:

export default {
  output: {
    minify: {
      cssOptions: {
        minimizerOptions: {
          errorRecovery: false,
        },
      },
    },
  },
};

#Switching minifier

#JS minifier

If the default SWC minifier does not meet your needs, you can switch to other minifiers through the tools.bundlerChain option.

For example, use terser-webpack-plugin to switch to Terser or esbuild.

• Use terser to minify JS code:

import TerserPlugin from 'terser-webpack-plugin';

export default {
  tools: {
    bundlerChain(chain, { CHAIN_ID }) {
      chain.optimization.minimizer(CHAIN_ID.MINIMIZER.JS).use(TerserPlugin, [
        {
          // options
        },
      ]);
    },
  },
};

• Use esbuild to minify JS code, you need to install the esbuild package and set esbuildMinify:

import TerserPlugin from 'terser-webpack-plugin';

export default {
  tools: {
    bundlerChain(chain, { CHAIN_ID }) {
      chain.optimization.minimizer(CHAIN_ID.MINIMIZER.JS).use(TerserPlugin, [
        {
          minify: TerserPlugin.esbuildMinify,
        },
      ]);
    },
  },
};