Take your WordPress development to new heights. Check out Redux Framework, from the makers of Elusive Icons.

  Get Started

Easy ways to get Elusive Icons 2.0.0 onto your website

Setting up Elusive Icons can be as simple as adding two lines of code to your website, or you can be a pro and customize the LESS yourself! Elusive Icons even plays nicely with Bootstrap 3!

Thanks to the generous folks at MaxCDN, you can use Bootstrap CDN to add Elusive Icons into your website with a single line of code. You don't even have to download or install anything!

  1. Paste the following code into the <head> section of your site's HTML.
    <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/elusive-icons/2.0.0/css/elusive-icons.min.css">
    

    Immediately after release, it takes a bit of time for BootstrapCDN to catch up and get the newest version live on their CDN.

  2. Pat yourself on the back for your scalable-vector-icons-on-the-website judo solution in a single line of code.
  3. Check out the examples to start using Elusive Icons!

Use this method to get the default Elusive Icons CSS.

  1. Copy the entire elusive-icons directory into your project.
  2. In the <head> of your html, reference the location to your elusive-icons.min.css.
    <link rel="stylesheet" href="path/to/elusive-icons/css/elusive-icons.min.css">
    
  3. Check out the examples to start using Elusive Icons!

Use the Official Elusive Icons LESS Ruby Gem to easily get Font Awesome LESS into a Rails project. Generously maintained by @supercodepoet.

  1. Add this line to your application's Gemfile:
    gem 'elusive-icons-less'
    
  2. And then execute:
    $ bundle
    
  3. Or install it yourself as:
    $ gem install elusive-icons-less
    

If you use Rails, add this to your e.g. application.less:

  @import "elusive-icons-sprockets";
  @import "elusive-icons";

Use the Official Elusive Icons SASS Ruby Gem to easily get Font Awesome SASS into a Rails or Compass project. Generously maintained by @supercodepoet.

  1. Add this line to your application's Gemfile:
    gem 'elusive-icons-sass'
    
  2. And then execute:
    $ bundle
    
  3. Or install it yourself as:
    $ gem install elusive-icons-sass
    

If you use Rails, add this to your e.g. application.scss:

  @import "elusive-icons-sprockets";
  @import "elusive-icons";

Use this method to customize Elusive Icons 2.0.0 using LESS or SASS.

  1. Copy the elusive-icons/ directory into your project.
  2. Open your project's elusive-icons/less/variables.less or elusive-icons/scss/_variables.scss and edit the @el-font-path or $el-font-path variable to point to your font directory.
    @el-font-path:   "../font";
    

    The font path is relative from your compiled CSS directory.

  3. Re-compile your LESS or SASS if using a static compiler. Otherwise, you should be good to go.
  4. Check out the examples to start using Elusive Icons!

In order to provide the best possible experience to old and buggy browsers, Elusive Icons uses CSS browser hacks in several places to target special CSS to certain browser versions in order to work around bugs in the browsers themselves. These hacks understandably cause CSS validators to complain that they are invalid. In a couple places, we also use bleeding-edge CSS features that aren't yet fully standardized, but these are used purely for progressive enhancement.

These validation warnings don't matter in practice since the non-hacky portion of our CSS does fully validate and the hacky portions don't interfere with the proper functioning of the non-hacky portion, hence why we deliberately ignore these particular warnings.

If you need IE7 support, you have my condolences. Really. Elusive Icons 2.0.0 doesn't support IE7. Please go complain to whomever decided your project needs IE7 support.

If you're having trouble with Elusive Icons, make sure to check out the troubleshooting wiki page. Generously maintained by @gtagliala.