gulp-uncss is a Gulp plugin that removes unused CSS from your stylesheets based on the actual usage in your HTML files. It does not directly analyze JavaScript files or Dust templates. However, you can use additional tools in combination with gulp-uncss to achieve a more comprehensive unused CSS removal process that includes JavaScript and Dust templates.

Here's a general workflow to remove unused CSS from your project, including usage in JavaScript and Dust templates:

  1. Use gulp-uncss for HTML Files: Use gulp-uncss to process your HTML files and remove unused CSS. Set up a Gulp task to target your HTML files and apply the uncss plugin. For example:

    const gulp = require('gulp'); const uncss = require('gulp-uncss'); gulp.task('uncss', function() { return gulp.src('path/to/css/styles.css') .pipe(uncss({ html: ['path/to/index.html', 'path/to/otherpage.html'] })) .pipe(gulp.dest('path/to/dest')); });
  2. Use Webpack or Rollup with PurifyCSS for JavaScript Files: Instead of gulp-uncss, you can use Webpack or Rollup with the purifycss-webpack or rollup-plugin-purifycss plugins to remove unused CSS from your JavaScript files. These plugins analyze your JavaScript code and extract class names used in your project to keep only the relevant CSS in your final output.

    For example, if you're using Webpack, you can set up your configuration like this:

    const path = require('path'); const PurifyCSSPlugin = require('purifycss-webpack'); module.exports = { // ... other webpack configuration plugins: [ new PurifyCSSPlugin({ paths: ['path/to/index.html', 'path/to/otherpage.html', 'path/to/js/*.js'] }) ] };
  3. Handle Dust Templates Separately: Dust templates typically use dynamic data rendering, which makes it challenging to analyze their usage statically. To handle Dust templates, you can manually remove unused CSS classes from your stylesheets based on the classes actually used in your Dust templates. This process may require some manual effort, but it ensures that you remove CSS that is not being utilized.

Remember that removing unused CSS can lead to unintended consequences if not done carefully. Always thoroughly test your application after applying these optimizations to ensure that you don't accidentally remove CSS that might be needed in specific scenarios. Also, consider implementing automated tests or visual regression tests to catch any CSS-related issues during development.

Have questions or queries?
Get in Touch