vite-plugin-optimize-css-modules weekly downloads statistics

Vite Plugin - Optimize CSS Modules

Mangle classnames in production - save up to 30% on css and 90% of build time for free!

Setup

This plugin requires vite of v3 or greater. It only makes sense to use if you're using css modules.

In your vite.config.ts simply add the plugin:

And that's it. When running vite build your generated CSS should be significantly smaller.

Benchmarks

Benchmarks are done against bootstrap and materialize.css assuming all the classes are used as css modules. The benchmark code is located in the benchmarks directory.

Run them by building the plugin via npm run build and then running npm run benchmarks. The results below are from a MacBook Air M2 with node v22.8.0, ran on the 31th December 2024.

| Input | Build Time | Gzip Size | Brotli Size |

| bootstrap-5.0.2.module.css | 525ms (_-94.06%_ / _-8311ms_) | 21.3 kB (_-26.53%_ / _-7.69 kB_) | 21.3 kB (_-27.54%_ / _-6 kB_) | | materialize-1.0.0.module.css | 572ms (_-92.59%_ / _-7156ms_) | 20.1 kB (_-19.70%_ / _-4.93 kB_) | 20.1 kB (_-21.33%_ / _-4.3 kB_) |

How does it work?

By default, when using css modules, you end up with hashes or other long class-names in your bundled css files:

By using this module, the smalles possible classname will be used for each "id":

Description from the npm listing.