Home

Awesome

PurgeCSS

npm npm GitHub Dependabot

<p align="center"> <img src="https://i.imgur.com/UEiUiJ0.png" height="200" width="200" alt="PurgeCSS logo"/> </p>

What is PurgeCSS?

When you are building a website, chances are that you are using a css framework like Bootstrap, Materializecss, Foundation, etc... But you will only use a small set of the framework and a lot of unused css styles will be included.

This is where PurgeCSS comes into play. PurgeCSS analyzes your content and your css files. Then it matches the selectors used in your css files with the ones in your content files. It removes unused selectors from your css, resulting in smaller css files.

Sponsors 🥰

<img src="https://avatars0.githubusercontent.com/u/67109815?v=4" height="85" style="margin-right: 10px"> <img src="https://avatars.githubusercontent.com/u/133211198?v=4" height="85" style="margin-right: 10px">

Documentation

You can find the PurgeCSS documentation on this website.

Table of Contents

PurgeCSS

Plugins

Guides

Getting Started

Installation

npm install purgecss --save-dev

Usage

import { PurgeCSS } from "purgecss";
const purgeCSSResults = await new PurgeCSS().purge({
  content: ["**/*.html"],
  css: ["**/*.css"],
});

Packages

This repository is a monorepo that we manage using Lerna. That means that we actually publish several packages to npm from the same codebase, including:

PackageVersionDescription
purgecssnpmThe core of PurgeCSS
postcss-purgecssnpm (scoped)PostCSS plugin for PurgeCSS
purgecss-webpack-pluginnpmWebpack plugin for PurgeCSS
gulp-purgecssnpmGulp plugin for PurgeCSS
grunt-purgecssnpmGrunt plugin for PurgeCSS
rollup-plugin-purgecssnpmRollup plugin for PurgeCSS
purgecss-from-htmlnpmHtml extractor for PurgeCSS
purgecss-from-pugnpmPug extractor for PurgeCSS
purgecss-with-wordpressnpmCollection of safelist items for WordPress
vue-cli-plugin-purgecssnpmVue CLI Plugin for PurgeCSS