Recess\* Property Order [][stylelint]

[![npm version][npm-img]][npm-url]
[![npm downloads][npm-dls]][npm-url]
[![github issues][issues-img]][issues-url]

A [Stylelint] config that sorts CSS properties the way [Recess] did and
Bootstrap [did]/[does].

\*With some modifications & additions for modern properties.

Usage

1. Add [stylelint], [stylelint-order], and this package to your project:
``sh npm install --save-dev stylelint stylelint-order stylelint-config-recess-order`2. Configure your Stylelint configuration file to extend this package:`js module.exports = { extends: ['stylelint-config-recess-order'], rules: { // Add overrides and additional rules here }, }`

`Advanced`

The default setup applies only the 'order/properties-order'rule with the various property groups. If you need to configure other options for this rule, the groups can be imported separately and the rule configured to your needs.

`js const propertyGroups = require('stylelint-config-recess-order/groups')

module.exports = { extends: [], // Do not extend the config here. rules: { // Configure the rule manually. 'order/properties-order': propertyGroups.map((group) => ({ ...group, emptyLineBefore: 'always', noEmptyLineBetween: true, })), }, }``

References

[@mdo on CSS Property Order][mdo-order]

[npm-url]: https://www.npmjs.com/package/stylelint-config-recess-order
[npm-img]: https://img.shields.io/npm/v/stylelint-config-recess-order.svg?style=flat-square
[npm-dls]: https://img.shields.io/npm/dt/stylelint-config-recess-order.svg?style=flat-square
[issues-url]: https://github.com/stormwarning/stylelint-config-recess-order/issues
[issues-img]: https://img.shields.io/github/issues/stormwarning/stylelint-config-recess-order.svg?style=flat-square
[stylelint]: https://github.com/stylelint/stylelint
[stylelint-order]: https://github.com/hudochenkov/stylelint-order
[recess]: https://github.com/twitter/recess/blob/29bccc870b7b4ccaa0a138e504caf608a6606b59/lib/lint/strict-property-order.js
[did]: https://github.com/twbs/bootstrap/blob/f58997a0dae54dc98d11892afef9acb85bdc6a1e/.scss-lint.yml#L136
[does]: https://github.com/twbs/stylelint-config-twbs-bootstrap/blob/ad67be6e4ceb48809fa1dce13b7892f9d2018995/css/index.js#L38
[mdo-order]: https://markdotto.com/blog/css-property-order/

Usage

1. Add [stylelint], [stylelint-order], and this package to your project:
``

sh
    npm install --save-dev stylelint stylelint-order stylelint-config-recess-order


2.  Configure your Stylelint configuration file to extend this package:

js
    module.exports = {
    	extends: ['stylelint-config-recess-order'],
    	rules: {
    		// Add overrides and additional rules here
    	},
    }

Advanced

The default setup applies only the 'order/properties-order'

 rule with the 
various property groups. If you need to configure other options for this rule,
the groups can be imported separately and the rule configured to your needs.

js
const propertyGroups = require('stylelint-config-recess-order/groups')

module.exports = {
	extends: [], // Do not extend the config here.
	rules: {
		// Configure the rule manually.
		'order/properties-order': propertyGroups.map((group) => ({
			...group,
			emptyLineBefore: 'always',
			noEmptyLineBetween: true,
		})),
	},
}

References

[@mdo on CSS Property Order][mdo-order]