Express middleware that compiles less files to css on the way out.
JavaScript CSS
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.


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.


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';

    .use(compiless({root: root}))


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