csscomb

CSScomb

CSScomb is a coding style formatter for CSS. You can easily write your own configuration to make your style sheets beautiful and consistent.

The main feature is sorting properties in a specific order. It was inspired by @miripiruni's PHP-based tool of the same name. This is the new JavaScript version, based on the powerful CSS parser Gonzales PE.

1. Install

Global installation (for use as a command-line tool):

npm install csscomb -g

Local installation (for use as a command-line tool within current directory):

npm install csscomb

To install as a project dependency (the package will appear in your dependencies):

npm install csscomb --save

To install as a dev dependency (the package will appear in your devDependencies):

npm install csscomb --save-dev

2. Configure

There are a number of ways to configure CSScomb:

• Use one of predefined configs
• Put .csscomb.json file in the project root.
• Set path to config's file
• Use *.css file as a template

3. Use

Command Line

csscomb assets/css

Node.js module

var Comb = require('csscomb');
var comb = new Comb('zen');
comb.processPath('assets/css');

4. Contribute

This project is actively mantained. But anyone and everyone is welcome to contribute. Please take a moment to review the guidelines for contributing.

Also you can become a mantainer. To do that please ping @tonyganch.

Authors

@mishanga, @tonyganch

Thanks for assistance and contributions:

@miripiruni, @anton-rudeshko, @cvrebert, @filtercake, @ignovak, @kizu, @lefoy, @L0stSoul, @mishaberezin, @puzankov, @schneyra, @thejameskyle, @vecmezoni

License

This software is released under the terms of the MIT license.

Other projects

• https://github.com/senchalabs/cssbeautify
• https://github.com/css/gonzales
• https://github.com/tonyganch/gonzales-pe
• https://github.com/css/csso
• https://github.com/nzakas/parser-lib

Changelog

4.3.0 - 2019-04-17

• Updated GPE to v4.2.4
• Updated list of supported Node version to reflect https://nodejs.org/en/about/releases/
• Fixed lines-between-rulesets when file starts with a comment (#525)
• Fixed space-before-combinator handling of leading/lone combinators (#551)
• Fixed parsing of cli --tty-mode option as boolean