Grunt task to lint and minify CSS or LESS
Pull request Compare This branch is 1 commit ahead, 93 commits behind sindresorhus:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Grunt task to lint and minify CSS or LESS, using the Twitter RECESS module:

Developed at Twitter to support our internal styleguide, RECESS is a simple, attractive code quality tool for CSS built on top of LESS.

Incorporate it into your development process as a linter, or integrate it directly into your build system as a compiler, RECESS will keep your source looking clean and super manageable.

Getting Started

Install this grunt plugin next to your project's grunt.js gruntfile with: npm install grunt-recess

Then add this line to your project's grunt.js gruntfile:



This grunt task is a multi task, which means you can specify multiple subtasks and grunt will iterate over them. The dist below is a subtask, you could e.g. create a dev subtask to handle stuff while developing.

Example usage


recess: {
    dist: {
        src: ['src/main.css']

Lint and compile

recess: {
    dist: {
        src: ['src/main.less'],
        dest: 'dist/main.css',
        options: {
            compile: true

dest is only needed when compile: true, it won't output any warnings in this mode. You can also specify .less files and they will be compiled.

Lint, compile and concat

recess: {
    dist: {
        src: [
        dest: 'dist/combined.css',
        options: {
            compile: true

You can specify more than one src to concat the files.


// Default
compile: false,
compress: false,
noIDs: true,
noJSPrefix: true,
noOverqualifying: true,
noUnderscores: true,
noUniversalSelectors: true,
prefixWhitespace: true,
strictPropertyOrder: true,
zeroUnits: true


Grunt currently doesn't have a way to test tasks directly. You can test this task by running grunt and check that it passes on the valid files and fails on the invalid.


In lieu of a formal styleguide, take care to maintain the existing coding style.


MIT License (c) Sindre Sorhus