rollup-plugin-minify-template-literals

1.1.7 verified Mon Apr 27 auth: no javascript

A Vite/Rollup plugin that minifies HTML and CSS markup inside JavaScript/TypeScript template literal strings. Version 1.1.7 ships TypeScript types and requires Node >=20.0.0. It is maintained at a moderate cadence. Key differentiators: supports both Vite and Rollup, integrates minify-literals under the hood, offers include/exclude filtering, optional failOnError mode, and is ESM-only. Compared to alternatives like rollup-plugin-minify-html-literals, this plugin is a modern fork with bug fixes and ES module support.

Common errors

error ERR_REQUIRE_ESM ↓

cause Attempting to require an ESM-only package.

fix

Change to import or use dynamic import().

error Cannot find module 'minify-literals' ↓

cause Missing peer dependency minify-literals.

fix

Run npm install minify-literals in your project.

error TypeError: minifyTemplateLiterals is not a function ↓

cause Incorrect import style (e.g., using default import instead of named).

fix

Use import { minifyTemplateLiterals } from 'rollup-plugin-minify-template-literals'.

Warnings

breaking Node.js version 20+ required. Older versions may cause cryptic errors. ↓

fix Upgrade Node.js to version 20 or higher.

breaking ESM only. Traditional require() will throw an error. ↓

fix Use import syntax instead of require().

gotcha Minify template literals before transpiling to ES5, otherwise template literals containing expressions won't be found. ↓

fix Ensure the plugin runs before Babel or TypeScript compilation.

Install

npm install rollup-plugin-minify-template-literals

yarn add rollup-plugin-minify-template-literals

pnpm add rollup-plugin-minify-template-literals

Imports

minifyTemplateLiterals

wrong

const minifyTemplateLiterals = require('rollup-plugin-minify-template-literals')

correct

import { minifyTemplateLiterals } from 'rollup-plugin-minify-template-literals'

ESM-only; CommonJS require() will fail. The package is native ESM.

Options

wrong

import { Options } from 'rollup-plugin-minify-template-literals'

correct

import type { Options } from 'rollup-plugin-minify-template-literals'

TypeScript users should use type-only import to avoid runtime emission.

Quickstart

Shows basic Vite integration: import the plugin and add it to the plugins array.

import { defineConfig } from 'vite';
import { minifyTemplateLiterals } from 'rollup-plugin-minify-template-literals';

export default defineConfig({
  plugins: [minifyTemplateLiterals()],
});