Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Compiles LESS on a per request basis in Express
JavaScript
Branch: master

This branch is 1 commit ahead, 52 commits behind vernak2539:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

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

README.md

Express LESS Middleware Build Status Coverage Status

This middleware is designed to compile LESS on the fly.

Installing

npm install express-less-middleware --save

Should only be used for development. LESS should be compiled during a build process

What this does (per request)

  1. Determines if file requested is: (if conditions aren't met it runs next())
    1. requested via GET method
    2. a CSS file
  2. Looks for CSS file requested
    • if found it will let it go through the original flow via next
  3. Looks for a LESS file with the same name as the CSS file requested
    • if LESS file is found it will read that file and compile it to CSS and deliever the response
  4. If no LESS or CSS file is found, it will give you a 404 like usual

What this doesn't do

  1. Look for changes on save (if you use it, you won't need a grunt watch on less files)

Example

var http         = require( 'http' );
var express      = require( 'express' );
var app          = express();

// this assumes that the publicly available folder is on the same directory level
// as the file that starts your express server
var lessCompiler = require( 'express-less-middleware' )();

// if that's not the case, initialize it with the path to your public/client-side folder
// the path should be relative to the directory where the file that starts your express server is
// ex) var lessCompiler = require( 'express-less-middleware' )( '../path/to/public/folder' );


// ....everything else that has to do with configuring

// you should only use this when developing. Not meant for production
app.configure( 'dev', function() {
    // this must be "used" before express.use( express.static() ) or it will not work (no next())
    app.use( lessCompiler );
});

// ....other stuff relative to your express app

http.createServer( app ).listen( 8000 );

License

MIT

Something went wrong with that request. Please try again.