The `icomoon-rails` gem integrates the free icon pack of `IcoMoon` with the Rails asset pipeline. It also provide a way to fork with your won icon fonts.
Switch branches/tags
Nothing to show
Latest commit 701f9d8 Apr 1, 2014 @tsechingho Merge pull request #2 from tofumatt/patch-1
Fix typo in README


IcoMoon provides an application to create your own icon fonts, and also releases an icon pack for free.

The icomoon-rails gem integrates the free icon pack of IcoMoon with the Rails asset pipeline. It also provide a way to fork with your own icon fonts.

It is highly recommanded to create your own fork.


Install icomoon-rails gem

Add this line to your application's Gemfile:

gem 'icomoon-rails'

And then execute:


Include icomoon-free stylesheet assets

Add to your app/assets/stylesheets/application.css

*= require icomoon-free/style

IE7 suppot

If you need to support IE7, there is a icomoon-free/lte-ie7.js in javascripts assets.

Use this stylesheet with conditional comment may be the best way to support IE7. But it can be difficult when it comes to assets pipeline. See this article on StackOverflow for a workaround: Using Rails 3.1 assets pipeline to conditionally use certain css



You can go to IcoMoon App to create your own fonts pack.

  1. select the fonts you needed, and click 'Font->' button
  2. click 'More Settings' to set your font name and CSS class prefix
  3. click 'Save/Load' to save your font pack for futher use
  4. click 'Download' to download your font pack as zip file
  5. fork this gem from github
  6. follow gem maintenace section and replace NAME and ZIP value to create your own fonts assets
  7. use gem 'icomoon-rails', git: 'xxxxxx' in your Gemfile instead
  8. follow other part of usage section

Gem maintenance

Maintain icomoon-rails gem with Rake commands.

Download icon fonts from IcoMoon App.

Update icomoon-free source files.

rake update-icomoon NAME=icomoon-free ZIP=~/Download/

Publish gem.

rake release


The assets from IcoMoon free icon pack use CC License (CC BY-SA 3.0).

Other parts of gem use MIT license.