purgecss

Remove unused CSS

MIT License

Downloads
4.8M
Stars
7.8K
Committers
90
View Code on GitHub Visit Website
Ecosystems: PostCSS, Gulp, CSS

Bot releases are visible (Hide)

purgecss - v6.0.0 Latest Release

Published by Ffloriel 7 months ago

Bug Fixes

Features

Breaking changes

  • Supports NodeJS 18+

What's Changed (full list)

New Contributors

Full Changelog: https://github.com/FullHuman/purgecss/compare/v5.0.0...v6.0.0

purgecss - v5.0.0

Published by Ffloriel about 2 years ago

Bug Fixes

  • add safelist variables to postcss-purgecss #840 (c822058)
  • gulp-purgecss: support skippedContentGlobs option #853 (b72de77)
  • Purgecss webpack plugin/only filter fix (#933) (f8e4c2c)
  • purgecss-webpack-plugin: add sourcemap support #409 (b3f73ed)
  • purgecss-webpack-plugin: export as named export as well as default (#821) (a6a2c8e)
  • wrong path import (4f3ddd0)

Features

  • add source map support #526 (f2a9c5a)
  • gulp-purgecss: add support for gulp-sourcemaps #257 (55c26d2)
  • postcss-purgecss: load options from purgecss config (4de3bd8)
  • purgecss-webpack-plugin: load config file automatically #767 (726faaa)

BREAKING CHANGES

  • purgecss-webpack-plugin: drop webpack 4 support

What's Changed (generated commit list minus dependabot)

New Contributors

Full Changelog: https://github.com/FullHuman/purgecss/compare/v4.1.3...v5.0.0

purgecss - v4.1.0

Published by Ffloriel almost 3 years ago

Bug Fixes

  • Allow Absolute Paths (#679) (15335a2)
  • css variable removed when declared in wrong order (89ece42), closes #518
  • Fix interaction with other plugins (#647) (fb08e3a)
  • grunt-purgecss: Fix plugin not ouputting all files (#723) (646e419)
  • gulp-purgecss: fix support for stream input (fd5d3bf)
  • Keep keyframe decimals for prefixed @keyframes (#749) (b804441)
  • purgecss-from-pug: class attribute with multiple values not correctly handled with pug (#678) (ba6285d), closes #677

Features

What's Changed

New Contributors

Full Changelog: https://github.com/FullHuman/purgecss/compare/v4.0.3...v4.1.0

purgecss - v4.0.0

Published by Ffloriel over 3 years ago

Breaking Changes

Drop PostCSS 7 support, use @fullhuman/postcss-purgecss 3.0 with PostCSS 7.

purgecss - v3.1.3

Published by Ffloriel almost 4 years ago

Changes

  • postcss-purgecss remove postcss 8 as peer dependency
  • purgecss-webpack-plugin fix backward compatibility with webpack 4
  • PurgeCSS Update to PostCSS 8
  • postcss-purgecss Add compatibility with PostCSS 8
  • purgecss-webpack-plugin Fix deprecation warning with Webpack 5

Bug Fixes

purgecss - v3.0.0

Published by Ffloriel about 4 years ago

3.0.0

Simplifying whitelist option

Whitelist started as a simple option named whitelist but grew up with the different use-cases and needs that appear with time. Another option called whitelistPatterns appeared, then whitelistPatternsChildren, …
It is now more complex and complicated, and somewhat difficult to remember how to use it with different options.

To summarize the changes, the whitelist options are now grouped in one option called safelist. And the most used options can be defined in one array.

Two forms are available. The simple form is:

safelist: ['invisibleClass', /^nav-/]

In this form, safelist is an array that can take a string or a regex.

The complex form is:

safelist: {
 standard: ['invisibleClass', /^nav-/],
 deep: [],
 greedy: [],
 keyframes: [],
 variables: []
}

In this form, safelist is an object taking optional properties:
standard is the same as the simple form and replaces whitelist and whitelistPatterns
deep replaces whitelistPatternsChildren
greedy is a new option coming from https://github.com/FullHuman/purgecss/pull/424
keyframes can be used to add keyframes to the safelist, when using keyframes: true (https://github.com/FullHuman/purgecss/issues/418)
variables can be used to add CSS variables to the safelist, when using variables: true

New Option: Blocklist

Blocklist will block the CSS selectors from appearing in the final output CSS. The selectors will be removed even when they are seen as used by PurgeCSS.

blocklist: ['usedClass', /^nav-/]

Even if nav-links and usedClass are found in your content files (HTML, Javascript), they will be removed.

CLI

PurgeCSS is using commander.js for its CLI. The recent version of commander.js introduced the possibility of making an option variadic. This means when specifying multiple option arguments, the parsed option value will be an array.
A few options are now taking advantage of this new feature: content, css, and the newly introduced option safelist and blocklist. It is no longer necessary to separate the list items with a comma.

From changelog:

  • CLI: add blocklist option (3961afb)
  • add blocklist option (04223f7)
  • add safelist option, replace whitelist
  • add safelist keyframes and css variables (dc59d30), closes #418 #439
purgecss - v2.0

Published by Ffloriel over 4 years ago

Changes:

  • Asynchronous
import PurgeCSS from "purgecss";

const purgecssResults = await new PurgeCSS().purge({
    // options
});
  • Extractor is a function
content => content.match(/[\w-/:]+(?<!:)/g) || []
  • variables option to remove unused CSS variables
  • Drop support of NodeJS < 8
purgecss - 1.4.2

Published by Ffloriel almost 5 years ago

purgecss - v1.4.1

Published by Ffloriel almost 5 years ago

  • Merge pull request #210, ability to exclude current rule with a ignore comment placed inside of it
  • Merge pull request #229, Fix the config file path of windows
  • update dependencies
purgecss - v1.4.0

Published by Ffloriel about 5 years ago

purgecss - v1.3.0 - Netero

Published by Ffloriel over 5 years ago

purgecss - v1.2.0 - Eighteen

Published by Ffloriel over 5 years ago

purgecss - v1.1.0 - Incredibles

Published by Ffloriel about 6 years ago

  • Fix issue #92 where value between rounded brackets for nth-child and nth-of-type pseudo-class gets purged if it starts with 'n' or '-n'
  • Update dependencies, including PostCSS 7
purgecss - 1.0.0 - Fate

Published by Ffloriel over 6 years ago

purgecss - v0.20.1

Published by Ffloriel over 6 years ago

purgecss - v0.20.0 - Luffy

Published by Ffloriel over 6 years ago

purgecss - v0.19.0 - Zangetsu

Published by Ffloriel almost 7 years ago

purgecss - v0.18.0 - Iron Man

Published by Ffloriel almost 7 years ago

purgecss - v0.16.0 - Aang

Published by Ffloriel almost 7 years ago

Package Rankings
Top 0.62% on Npmjs.org
Top 15.36% on Repo1.maven.org
Top 4.53% on Proxy.golang.org
Badges
Extracted from project README
npm
Related Projects
postcss-loader

PostCSS loader for webpack

03 Oct 2014 2,850
js-var-to-css-var

Generate CSS/LESS variables and TS Types from JS/TS

18 Dec 2022 4
postcss

Transforming styles with JS plugins

24 Sep 2013 28,172
gatsby-plugin-purgecss

Gatsby plugin for purgecss. Removes unused css/sass/less/stylus. Supports tailwind, bootstrap, bu...

11 Jul 2018 76
bit-css

用原子类赋予元素属性，减少甚至不写css

17 Aug 2020 18
compiled

A familiar and performant compile time CSS-in-JS library for React.

13 Dec 2019 1,962
rollup-plugin-styles

🎨 Universal Rollup plugin for styles: PostCSS, Sass, Less, Stylus and more.

12 Mar 2020 244