csscombx

CSScomb

The current fork of the CSScombx coding style formatter is specifically intended to comply with the Drupal CMS coding standards. The default configuration might be found in the config/drupal.json file. You can easily write your own configuration to make your style sheets beautiful and consistent. Just copy some of the config/*.json files, put it into your project's root and rename the file to .csscombx.json (see the leading dot). Then edit the file according your needs. Note that any of a project child folders may have its own .csscombx.json file with different settings.

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.

0. Maintenance mode

The tool has a restricted support on the current fork.

If you'd like to become a maintainer of this project, please ping @drugan.

1. Install

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

npm install csscombx -g

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

npm install csscombx

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

npm install csscombx --save

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

npm install csscombx --save-dev

2. Configure

There are a number of ways to configure CSScomb:

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

3. Use

Command Line

Process all *.css, *.scss, *.sass or *.less files found in the ./my-styles folder or any of its child folders.

csscombx ./my-styles

Node.js module

Process files like the above using config/zen.json configuration file.

var Comb = require('csscombx');
var comb = new Comb('zen');
comb.processPath('./my-styles');

4. Contribute

Anyone and everyone is welcome to contribute. Please take a moment to review the guidelines for contributing.

Authors

@mishanga, @tonyganch

Thanks for assistance and contributions:

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

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