Purging unused styles in Tailwind

Introduction

Purging unused styles helps make your website load faster by removing CSS you don't use.

When your website feels slow because of large CSS files.

When you want to reduce the size of your final CSS for better performance.

When you use Tailwind CSS and want to keep only the styles your pages actually need.

When preparing your website for production to improve loading speed.

When you want to avoid sending unnecessary code to users.

Syntax

Tailwind

module.exports = {
  content: ['./src/**/*.{html,js}'],
  theme: {
    extend: {},
  },
  plugins: [],
};

The content array tells Tailwind where to look for class names to keep.

Only styles used in these files will be included in the final CSS.

Examples

This example purges unused styles by scanning only index.html.

Tailwind

module.exports = {
  content: ['./index.html'],
  theme: {},
  plugins: [],
};

This example scans all JavaScript and TypeScript files in the src folder.

Tailwind

module.exports = {
  content: ['./src/**/*.{js,jsx,ts,tsx}'],
  theme: {},
  plugins: [],
};

This example scans HTML files in public and Vue/JS files in src.

Tailwind

module.exports = {
  content: ['./public/**/*.html', './src/**/*.{vue,js}'],
  theme: {},
  plugins: [],
};

Sample Program

This simple HTML page uses Tailwind classes for background color, padding, text size, font weight, and colors.

When you build your CSS with purge enabled, only these used styles will be included in output.css.

Tailwind

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>Tailwind Purge Example</title>
  <link href="./dist/output.css" rel="stylesheet">
</head>
<body class="bg-gray-100 p-6">
  <h1 class="text-3xl font-bold text-blue-600">Hello, Tailwind!</h1>
  <p class="mt-4 text-gray-700">This page uses only a few Tailwind styles.</p>
</body>
</html>

Important Notes

Make sure the content paths in your Tailwind config match where your HTML or JS files are.

If you forget to include a file, styles used there might get removed.

During development, you can disable purging for faster builds, then enable it for production.

Summary

Purging removes unused Tailwind CSS styles to make your site faster.

Set the content option in your Tailwind config to tell it where to look for used classes.

Always check your final CSS size and test your site after purging to avoid missing styles.

Practice

1. What is the main purpose of purging unused styles in Tailwind CSS?

easy

A. To remove unused CSS classes and make the site load faster

B. To add more CSS classes automatically

C. To change the colors of the website

D. To create new HTML elements

Solution

1. Step 1: Understand what purging means

   Purging means removing things that are not needed. In Tailwind CSS, it removes unused styles.

2. Step 2: Know why removing unused styles helps

   Removing unused styles makes the CSS file smaller, so the website loads faster.

3. Final Answer:

   To remove unused CSS classes and make the site load faster -> Option A

4. Quick Check:

   Purging = Remove unused styles = Faster site [OK]

Hint: Purging means removing unused CSS to speed up loading [OK]

Common Mistakes:

• Thinking purging adds styles instead of removing
• Confusing purging with changing colors or layout
• Believing purging creates new HTML elements

2. Which Tailwind config option tells Tailwind where to look for used CSS classes to purge?

easy

A. theme

B. content

C. plugins

D. variants

Solution

1. Step 1: Identify the config option for purging

   The content option lists files where Tailwind looks for class names to keep.

2. Step 2: Understand other options

   theme controls design tokens, plugins add features, variants control responsive states, so they don't control purging.

3. Final Answer:

   content -> Option B

4. Quick Check:

   content = files to scan for classes [OK]

Hint: Remember: content = where Tailwind looks for classes [OK]

Common Mistakes:

• Choosing theme instead of content
• Confusing plugins with purging config
• Using variants option wrongly

3. Given this Tailwind config snippet:

{
  content: ['./src/**/*.html'],
  theme: { extend: {} },
  plugins: []
}

Which files will Tailwind scan to keep CSS classes?

medium

A. All files in src folder and subfolders with .html extension

B. Only files named index.html in src folder

C. All JavaScript files in src folder

D. No files will be scanned

Solution

1. Step 1: Understand the glob pattern './src/**/*.html'

   This pattern means all .html files inside src and any subfolders.

2. Step 2: Match options with pattern meaning

   All files in src folder and subfolders with .html extension matches the pattern exactly. Options B and C are too narrow or wrong file types. No files will be scanned is incorrect.

3. Final Answer:

   All files in src folder and subfolders with .html extension -> Option A

4. Quick Check:

   ./src/**/*.html = all .html files in src and subfolders [OK]

Hint: ** means any folder depth, *.html means all HTML files [OK]

Common Mistakes:

• Thinking only top-level files are scanned
• Confusing file extensions scanned
• Assuming no files scanned without explicit mention

4. You set the content option incorrectly as ['./src/*.js'] but your classes are in HTML files inside subfolders. What problem will occur?

medium

A. Tailwind will include all styles correctly

B. Tailwind will generate duplicate CSS classes

C. Tailwind will throw a syntax error

D. Tailwind will purge needed styles causing missing styles on the site

Solution

1. Step 1: Analyze the content pattern './src/*.js'

   This pattern only scans JavaScript files directly inside src folder, not HTML or subfolders.

2. Step 2: Understand impact on purging

   Since HTML files with classes are not scanned, Tailwind thinks those classes are unused and removes them, causing missing styles.

3. Final Answer:

   Tailwind will purge needed styles causing missing styles on the site -> Option D

4. Quick Check:

   Wrong content path = missing styles after purge [OK]

Hint: Content must match all files with classes to avoid missing styles [OK]

Common Mistakes:

• Expecting Tailwind to scan files not listed
• Thinking wrong content causes errors instead of missing styles
• Assuming duplicate CSS classes will be generated

5. You want to purge unused styles but keep some dynamic classes added by JavaScript like bg-red-500 and text-xl. How can you ensure these classes are not removed?

hard

A. Write these classes directly in your HTML files only

B. Remove the content option entirely

C. Add these classes to the safelist option in Tailwind config

D. Use a plugin to disable purging

Solution

1. Step 1: Understand dynamic classes and purging

   Classes added by JavaScript are not in HTML files, so Tailwind may remove them during purge.

2. Step 2: Use safelist option to keep classes

   The safelist option lets you list classes to always keep, even if not found in scanned files.

3. Final Answer:

   Add these classes to the safelist option in Tailwind config -> Option C

4. Quick Check:

   Safelist = keep dynamic classes safe from purge [OK]

Hint: Use safelist to protect dynamic classes from purging [OK]

Common Mistakes:

• Removing content option disables purging but is not recommended
• Assuming writing classes in HTML fixes dynamic JS classes
• Thinking disabling purging plugin is best solution