Please take a look at the excellent rails-assets project before using this gem!


Gem Version

iCheck is a library for creating super customized checkboxes and radio buttons with JQuery & Zepto. This Gem packages iCheck for Ruby on Rails' asset pipeline

License: MIT License (just like iCheck)

Rails: 3.1 and up

This gem's major and minor version reflects the version of iCheck it packages (currently iCheck 1.0.2 is packaged by icheck-rails


If you are upgrading from iCheck version 0.9, the jquery.icheck.js and zepto.icheck.js files was removed and now it is just icheck.js


Add this line to your application's Gemfile:

gem 'icheck-rails'

And then execute:

$ bundle


Include the javascript part:

For Coffeescript

#= require 'icheck'

For JavaScript

//= require 'icheck'

Be sure to include JQuery or Zepto before requiring iCheck.

Include the style part:

iCheck includes several skins, most of them with multiple color schemes. Include them like this:

@import 'icheck/square/blue'
@import 'icheck/square/green'


@import 'icheck/square/_all' //includes all color schemes

Some skins don't have multiple color schemes. Include them like this:

@import 'icheck/futurico/futurico'

Then use markup like this:

    <input type="checkbox" class='icheck-me' data-skin="square" data-color="blue">

With an initializer like this:

function icheck(){
  if($(".icheck-me").length > 0){
      var $el = $(this);
      var skin = ($el.attr('data-skin') !== undefined) ? "_" + $el.attr('data-skin') : "",
      color = ($el.attr('data-color') !== undefined) ? "-" + $el.attr('data-color') : "";
      var opt = {
        checkboxClass: 'icheckbox' + skin + color,
        radioClass: 'iradio' + skin + color,



  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request