Less module compatible with Coffeescript module

This version of the less module has been adapted to be compatible with the coffeescript module (or other software using Rhino 1.7). If you don’t experience issues, use the regular less module versions.

This module allows you to use LESS stylesheets in your Play application, without having to manually compile them to CSS. It is inspired by the sass plugin that does a similar thing for sass.

Usage

Add the less module to your application.conf:

module.less=${play.path}/modules/less

Now any file in your public/ directory that ends in .less is automatically processed by the plugin, and outputted as CSS.

Example

Create a file called public/stylesheets/style.less, with contents:

@color: red;
h1 {
  color: @color;
}

Now, add the stylesheet to your main template in app/views/main.html:

<link type="text/css" rel="stylesheet" href="@{'public/stylesheets/style.less'}" />

Caching

The less module sets and listens to Last-Modified and ETag headers, so most browsers will retrieve the file only once. At the server, a compiled CSS file is stored in the cache, and automatically invalidated when the less file changes, or when one of the imported files change. So you can change your less files even while Play is running in production mode.

Notes

In case of an error in your less file, the error will be shown on your page to help you debug.