polish-css

• Overview
• Quick start
• Installation
• Example plugins
• License

Overview

Spend less time reviewing pull requests. Make learning your rules simpler for new additions to the team. Keep your code more consistent and more reliable...

Or don't. You're the boss.

Manicure your CSS with Polish.

Features:

• Totally unopinionated.
• Totally plugin based.
• Totally named in honor of the nail polish emoji.

Polish works with CSS, SCSS, Sass, and Less.

Quickstart

Do this:

var polish = require('polish-css');

Then do this:

var stylesheet       = '#css { color: red; }',
    pathToStylesheet = '/path/to/stylesheet',
    myPrivateModules = require('./path/to/private/modules'),
    pluginsToUse     = [
      {
        module   : 'polish-no-styling-ids',
        severity : 2
      },
      {
        module        : myPrivateModules.someLinter,
        severity      : 2,
        lintingOption : ['.things', '.to', '.pass', '.to', '.the', '.linter']
      }
    ],
    results;

results = polish(stylesheet, pathToStylesheet, pluginsToUse);

polish.reporter(pathToStylesheet, results.errors, results.warnings);

Linters can be ignored on a per-ruleset basis using inline commenting:

/* polish no-styling-ids=false */
#wont-be-reported {
  color: pink;
}

Installation

Install from npm: npm install polish-css

If you want to use the CLI, install Polish globally: npm install -g polish-css

Example plugins

• polish-banned-selectors Ban a list of selectors.
• polish-no-added-typography Prevent redefining typographic rules throughout your stylesheets.
• polish-use-color-variables Enforce defining your colors as variables (for Sass and SCSS).
• polish-use-box-shadow-mixin Enforce using a mixin to make box shadows (for Sass and SCSS).
• polish-no-calc-in-bg-position Ban using calc in background-position (it crashes older IE versions).
• polish-no-styling-ids Don't allow styling IDs.
• polish-only-extend-placeholders Make sure @extend is only used with placeholders (for Sass and SCSS).
• polish-no-bang-important Don't let anyone use !important.

License

This project is licensed under the terms of the MIT license.