Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Express middleware that compiles less files to css on the way out.
JavaScript CSS

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
test
.gitignore
.jshintignore
.jshintrc
.travis.yml
LICENSE
README.md
package.json

README.md

express-compiless

NPM version Build Status Coverage Status Dependency Status

Middleware that compiles less to css on-the-fly. Intended to be used in a development setting with the express.static middleware, but should work with any middleware further down the stack, even an http proxy.

The response will be rewritten under these circumstances:

  • If the response is served with a Content-Type of text/less.
  • If the request url ends in .less (excluding GET parameters) and the Content-Type is application/octet-stream (this is what Connect's static middleware does.

Compiless plays nice with conditional GET. If the original response has an ETag, compiless will add to it so the ETag of the compiled response never clashes with the original ETag. That prevents the middleware issuing the original response from being confused into sending a false positive 304 Not Modified if compiless is turned off or removed from the stack later.

Installation

Make sure you have node.js and npm installed, then run:

npm install express-compiless

Example usage

var express = require('express'),
    compiless = require('express-compiless'),
    root = '/path/to/my/static/files';

express()
    .use(compiless({root: root}))
    .use(express.static(root))
    .listen(1337);

License

3-clause BSD license -- see the LICENSE file for details.

Something went wrong with that request. Please try again.