Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

grunt-analyze-css - v1.0.x Built with Grunt npm version David DM David DM

Grunt task that analyze your css with analyze-css and compare the results to a user-defined benchmark.

This plugin requires Grunt ^0.4.5


npm i grunt-analyze-css --save-dev

Analyze css task

Run this task with the grunt analyzecss command.


analyze-css is a multi-task so it is possible to define global files and options, and then use specific values for specific targets.


    analyzecss: {
        files: ['stylesheet.css']
        prod: {
            // optional target specific options
        options: {
            outputMetrics: 'error',
            analyzecss: {
                // analyzecss specific options
            thresholds: {
                // custom thresholds values


These are the possible config values. The format is optionName: 'defaultValue'.

encoding: 'utf-8'

Defines the encoding when reading css files.

Possible values:

All supported values for fs.readFile can be used

analyzecss: {}

The analyzecss options. This object is directly passed on to analyzecss api.

Possible values:

See analyze-css readme file.

warn: 0.95

The score at which warning begins. Any metric that is below this mark will issue a warning.

Possible values:


error: 0.8

The score at which errors are thrown. Any metric that is below this mark will issue an error.

Possible values:


padLimit: 40

The length for default string padding in the results

Possible values:


outputMetrics: false

This options controls if and how metrics are shown to the screen. By default only the global score of each css document is shown. If set to true, ever metric score will show up. You can limit the output to set a cap on output by using 'warn' or 'error'.

Possible values:

true, false, 'warn', 'error'

outputDuplicateSelectors: false

This options will output duplicated selectors in stdout.

Possible values:

true, false

softFail: false

Prevents the grunt task to be halted if this task failed.

Possible values:

true, false

thresholds: { ... }

This object should contains all the maximum values allowed for each metric. The results of your css files will be compared to those maximum values and issue warning and errors if they surpass warn/error levels.

If you want to ignore certain metric, be sure to set them to null

Possible values:

See analyze-css readme file or the defaults in the source code.

reportFile: false

Enables writing the report to a file. In the case of a string, it will be used as a file path where the report is written in the format given in options.reportFormat.

Possible values:

false | string

reportFormat: 'json'

Determines the format of the options.reportFile.

JSON will be pretty printed, with two character indentation.

Possible values:

'json' | 'text'


Made with love in Montréal by

Licensed under the MIT License:


Grunt task that analyze your css with analyze-css and compare the results to a user-defined benchmark






No packages published