@e11ty/eleventy-plugin-html-terser

An Eleventy plugin for post-processing generated sites through the powerful html-minifier-terser.

Why?

Because terser is dope and does dope shit.

Install

The @11ty/eleventy module is a peer and needs to be installed along side it.

1pnpm add @e11ty/eleventy-plugin-html-terser @11ty/eleventy -D

Usage

Pass to the addPlugin method of eleventyConfig within a .eleventy.js or .eleventy.cjs configuration file. You can provide terser options to the terserOption property, which will use the defaults listed below. The runModes[] option allows you to (optionally) control modes that minification applies (defaults to all run modes).

Optionally use with 11ty.ts wrapper for type completions.

1const { defineConfig } = require('11ty.ts'); // Optional
2const { terser } = require('@e11ty/eleventy-plugin-html-terser');
3
4module.exports = defineConfig(eleventyConfig => {
5
6  eleventyConfig.addPlugin(terser, {
7    runModes: [], // Optionally specify the run modes for minification
8    terserOptions: {
9      collapseWhitespace: true,
10      minifyCSS: true,
11      minifyJS: true,
12      removeComments: true,
13      removeRedundantAttributes: true
14    }
15  });
16
17});

See the available minification options for terser.

License

Apache 2.0