npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

postcss-minify

v1.1.0

Published

PostCSS plugin to remove comments and unnecessary whitespace from CSS files

Downloads

56,916

Readme

postcss-minify

PostCSS plugin to remove comments and unnecessary whitespace from CSS files.

Input:

body {
  /* make it big and red */
  font-size: large;
  color: red;
}

Output:

body{font-size:large;color:red}

Usage

Install with npm install postcss-minify and use as you would any other PostCSS plugin.

Why

postcss-minify offers a minimalist alternative to sophisticated CSS optimizers like cssnano, csso and clean-css. These projects analyze your CSS and find ways to rewrite it in order to reduce the total character count. For example, they can merge rules with the same selector, rewrite longhand properties using shorthand equivalents, and precompute calc() expressions that evaluate to constants.

These clever techniques can help you squeeze a few more bytes out of your CSS, but they come with a lot of complexity. You may encounter bugs in these tools that make unsafe changes to your CSS, or find that changes which are theoretically safe behave surprisingly in older browsers. For some projects, the bytes saved may not be worth the risk incurred by this added complexity.

In contrast to these powerful optimizers, postcss-minify only makes trivial modifications to its input: it removes unnecessary whitespace and discards comments. This means it can be very simple (just 50 lines of code) and carry less risk of modifying your CSS in a way that breaks your website.

It turns out that in many situations, postcss-minify's naive approach to minification performs almost exactly as well as much more sophisticated techniques. Here's a quick experiment I ran where I minified bootstrap.css using various CSS optimizers and then compared the pre- and post-gzip size reductions.

| | clean-css | cssnano | csso | postcss-minify | |------------------------------------------------------|-------------|-----------|-----------|----------------| | version tested | 5.1.2 | 5.0.0 | 4.2.0 | 1.0.0 | | lines of code (sloc) | 7,170¹ | 8,159 | 2,534 | 50 | | minified size of bootstrap.css 5.0 (195,075 bytes) | 154,829 | 154,334 | 153,683 | 157,375 | | ratio to unminified bootstrap.css | 0.794 | 0.791 | 0.788 | 0.807 | | after gzipping minified output | 22,850 | 22,934 | 23,009 | 22,893 | | ratio to gzipped bootstrap.css 5.0 (25,238 bytes) | 0.905 | 0.909 | 0.912 | 0.907 |

As you can see, postcss-minify does almost as good a job of minifying this large, real-world CSS file as the more complex tools. And after gzip compression is applied to the results, the differences become insignificant. You'd save a mere 43 bytes by using clean-css over postcss-minify,² which even on a 2G mobile connection represents an increased download time of about 7ms.

Your mileage will vary of course. In certain situations (for example, when minifying CSS which was generated using Sass @mixins), advanced techniques will be able to substantially reduce the size of your CSS code by merging rules and deleting duplicate declarations. But in many cases, naive minification will get you 90% of the compression with 2% of the complexity.

1: clean-css includes its own CSS parser, while the others depend on either postcss or css-tree. To ensure a fair comparison, I've only included the code in the lib/optimizer/ directory of clean-css. The total codebase is about 10,125 SLOC.

2: That's about the length of this footnote.

License

This repository is made available under the MIT license; see the included LICENSE file for details.