Thanks to metaskills for making the less-rails-liftkit gem. This is based on that and this README is taken right from that project. For now.

Installing

This library requires the less-rails gem greater than 2.0.0 to work. Our gem spec will pull this and less in automatically. So all you need to do is bundle up less-rails-liftkit in your Gemfle.

gem 'less-rails-liftkit'

Usage

The easiest way to use Liftkit is require it in your application.css file. Doing so will compile the complete LESS libraries files for liftkit.

/*
 *= require lift/liftkit
*/

#foo {
  /* Your styles... */
}

In a file with the .css.less extension, you can import the entire liftkit LESS framework. This will allow you to use liftkit's variables and mixins in your CSS that follows. Remember, unlike other CSS frameworks, requiring or importing liftkit will include all the CSS for building a liftkitped website. If you only want variables or mixins, you will have to import those discreet files.

@import "lift/liftkit";

#foo {
  .border-radius(4px);
}

Maybe all you want to use is the variables and mixins that come with lift liftkit. No problem, just import them individually from you own .css.less file. In this case only the #foo selector is output.

@import "lift/liftkit/variables";
@import "lift/liftkit/mixins";

.myButton(@radius: 5px) {
  .border-radius(@radius);
}

#foo {
  .myButton(10px);
}

Using the JavaScript files is just as easy. Again, you can include all them with a single directive from your application.js file. Optionally, you can require only the files you need like require lift/liftkit/modal.

//= require lift/liftkit

$(document).ready(function(){

});