Question 1

How to use uCSS with login-protected pages?

Accepted Answer

You need to create a config file with an auth object that includes a login function. The README provides examples for Django and custom implementations, where you define a function to perform login and return a session cookie for uCSS to use during crawling.

Question 2

uCSS vs UnCSS: which is better for removing unused CSS?

Accepted Answer

uCSS is focused on identifying unused and duplicate CSS through crawling, while UnCSS is designed to automatically strip unused CSS. If you need analysis and reporting on large sites, uCSS is better; for automated removal in simpler setups, UnCSS is more suitable. uCSS even references UnCSS in its limitations.

Question 3

Can uCSS handle dynamic CSS from JavaScript?

Accepted Answer

uCSS cannot capture CSS rules that are switched on using JavaScript after page load without manual intervention. You can whitelist such selectors in the config file, but this requires prior knowledge of which classes are dynamic and may not cover all cases.

Question 4

How to integrate uCSS into a Grunt workflow?

Accepted Answer

There is a Grunt plugin called grunt-ucss available, as mentioned in the Installation section. You can install it and configure tasks in your Gruntfile to run uCSS as part of your build process for automated CSS analysis.

Question 5

What are the limitations of uCSS crawling?

Accepted Answer

uCSS cannot crawl pages that require form posts, strips parameters from links by default, and may miss unlinked pages. To analyze these, you must manually include them in the config file's pages.include list, as explained in the 'Nice to know' section.

Question 6

Is uCSS suitable for single-page applications?

Accepted Answer

uCSS is less ideal for SPAs because it relies on crawling static HTML pages. Since SPAs often have dynamic content loaded via JavaScript after initial page load, uCSS might not capture all CSS usage without extensive whitelisting and configuration.

uCSS

What is uCSS?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions