A simple, attractive code quality tool for CSS built on top of LESS
Developed at Twitter to support our internal styleguide, RECESS is a simple, attractive code quality tool for CSS built on top of LESS.
Incorporate it into your development process as a linter, or integrate it directly into your build system as a compiler, RECESS will keep your source looking clean and super manageable.
$ recess [path] [options]
@import:ed LESS files in.
Lint all css files
$ recess *.css
Lint file, ignore styling of IDs
$ recess ./bootstrap.css --noIds false
Lint file with compact output and no color
$ recess ./bootstrap.css --format compact --stripColors
Compile and compress .less file, then output it to a new file
$ recess ./bootstrap.less --compress > ./bootstrap-production.css
Watch a directory for changes and auto compile a css file from the changes. experimental
$ recess input.less:ouput.css --watch watch/this/dir/for/changes
Watch a single file for changes and auto compile a css file from the changes. experimental
$ recess input.less:ouput.css --watch
Recess provides a pretty simple programmatic api.
var recess = require('recess')
Once you've required recess, just pass it a
path (or array of paths) and an optional
options object and an optional
recess'../fat.css' '../twitter.css' compile: true callback
The following options (and defaults) are available in the programatic api:
The callback is fired when each instance has finished processessing an input. The callback is passed an array of of instances (one for each path). The instances have a bunch of useful things on them like the raw data and an array of output strings.
When compiling, access the compiled source through the output property:
var recess = require'recess'recess'./js/fat.css' compile: trueif err throw errconsole.logobj // recess instance for fat.cssobjoutput // array of loggable contentobjerrors // array of failed lint rules
To install recess you need both node and npm installed.
$ npm install recess -g
Copyright 2012 Twitter, Inc.
Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0