#HTML

Rspack can generate HTML through plugins and automatically inject emitted JavaScript and CSS assets. This guide covers two plugin options and how they differ in performance, features, and html-webpack-plugin compatibility.

#Choose a plugin

Rspack provides two plugin options for generating HTML:

• The built-in rspack.HtmlRspackPlugin is implemented in Rust and focuses on performance and common HTML generation needs.
• The standalone html-rspack-plugin is a JavaScript fork of html-webpack-plugin that prioritizes compatibility with its behavior.

#Performance

The built-in Rust implementation provides better build performance, especially when generating many HTML files. The JavaScript plugin also includes Rspack-specific optimizations but prioritizes compatibility.

#Features

rspack.HtmlRspackPlugin supports most html-webpack-plugin features, but cannot fully match all behaviors of the JavaScript implementation because its core logic runs in Rust. Use it when its features meet your needs and performance is the priority. Use html-rspack-plugin when migrating an existing html-webpack-plugin setup or when you need an unsupported option, capability, or behavior.

#Built-in HtmlRspackPlugin

rspack.HtmlRspackPlugin is included in @rspack/core, so no additional package is required.

import { rspack } from '@rspack/core';

export default {
  plugins: [new rspack.HtmlRspackPlugin()],
};

For all configuration options, see the plugin documentation.

#html-rspack-plugin

Install html-rspack-plugin separately:

npm add html-rspack-plugin -D

yarn add html-rspack-plugin -D

pnpm add html-rspack-plugin -D

bun add html-rspack-plugin -D

deno add npm:html-rspack-plugin -D

import HtmlRspackPlugin from 'html-rspack-plugin';

export default {
  plugins: [new HtmlRspackPlugin()],
};

For configuration options, see Options.

If you are migrating from html-webpack-plugin, see the webpack migration guide.