Skip to content

papandreou/express-compiless

Repository files navigation

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

Releases

Changelog

License

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

About

Express middleware that compiles less files to css on the way out.

Resources

License

Stars

Watchers

Forks

Packages

No packages published