uncss/uncss
Uncss
Uncss is a build pipeline CSS optimizer and optimization tool designed to remove unused styles from stylesheets. It analyzes HTML files to identify and strip selectors that do not match any elements in the markup, reducing the final stylesheet size and overall web page weight.
The tool functions as a DOM-based CSS analyzer that can simulate runtime document states. It provides mechanisms to preserve required selectors through the use of literal names, regular expressions, and specialized CSS comment markers to ensure styles triggered by user interactions are not deleted.
The project supports integration with build systems and task runners to automate the removal of dead CSS during the compilation process. It further enables the execution of custom JavaScript pre-processing scripts to modify the document state before analysis.
Features
- CSS Unused Style Removers - Provides a system to analyze the DOM and strip unused CSS selectors to reduce stylesheet size.
- CSS Build Tools - Acts as a build-time engine that scans source files to remove unused CSS styles.
- CSS Optimization - Provides a utility for purging unused CSS styles to optimize stylesheet size.
- CSS Payload Reduction - Analyzes HTML markup to delete redundant CSS rules, ensuring only essential styles are delivered.
- DOM Element Selectors - Matches CSS selectors against a parsed HTML document object model to determine which rules are actually applied.
- Stylesheet Management - Manages large stylesheets by stripping unnecessary rules while protecting essential selectors.
- Unused Style Removal - Analyzes HTML files to identify and delete styles from CSS stylesheets that are not used in the markup.
- Frontend Performance Optimization - Reduces CSS file size to improve page load times and browser rendering.
- CSS Purging - Identifies and removes unused CSS rules from stylesheets to reduce overall file size.
- Build System Integrations - Integrates with JavaScript build tools and style processors to remove unused CSS rules.
- CSS Rule Preservation Markers - Implements specialized CSS comment markers to flag style blocks that must be kept regardless of analysis.
- Build Pipeline Integrations - Automates the cleanup of unused stylesheets during the compilation process using build tools.
- Build Pipeline Integrators - Connects task runners and style processors to automatically clean up unused CSS during the build process.
- DOM State Simulation - Executes custom JavaScript scripts to modify the document state to account for dynamic class additions.
- Abstract Syntax Tree Parsing - Uses abstract syntax tree parsing to deconstruct stylesheets for rule removal without breaking CSS syntax.
- Asset Optimization Pipelines - Operates as a middleware step in build tools to strip unused styles after compilation.
- Interactive Selector Bindings - Preserves specific CSS selectors to ensure styles triggered by user interactions are not deleted.
- Preservation Lists - Prevents the removal of specific CSS rules using a list of selectors, regular expressions, or comments.
- Regex-Based Protection - Prevents the deletion of specific styles by matching selector names against user-defined regular expressions.
- Pre-Load Injections - Executes custom JavaScript before analysis to simulate runtime DOM changes for more accurate results.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
