modernizr-rails

The modernizr-rails gem will include the Modernizr.js library into your Rails 3.1+ app via the asset pipeline. This gem is bundled with the last tagged release version from the Modernizr GitHub repo, which is minified by the Rails Assets Pipeline for you automatically. If you need custom feature detection tests, consider the Custom feature detection tests section in this README.

Installation

Rails 3.x

Add the following to your assets group in your Gemfile:

group :assets do
  gem 'modernizr-rails'
end

Rails 4.x

Add the following into your Gemfile:

gem 'modernizr-rails'

Usage

Modernizr should be added to the <head> of your HTML. Be sure to check out the offical docs about Installing Modernizr for more info. Include it using the helper like so <%= javascript_include_tag :modernizr %>, Rails will take care of the compilation and minification automatically for you.

Example of your app/views/layouts/application.html.erb:

<html>
<head>
  <title>Your Awesome App</title>
  <%= stylesheet_link_tag    :application, media: :all %>
  <%= javascript_include_tag :modernizr %>
  <%= csrf_meta_tags %>
</head>
<body>
  ...
  <%= javascript_include_tag :application %>
</body>
</html>

Custom feature detection tests

If you need a custom feature detection test not included in the Modernizr build shipped with this gem, please consider using your own version instead of sending a pull request to include your test. You can easily do this by moving your Modernizr build in to one of the assets folder. Rails will automagically use your build instead of the shipped one. However you can still continue to use this gem and its features (like the precompile hook, and so on).

  1. Configure your build on modernizr.com/download.
  2. Download it.
  3. Rename it from modernizr.custom.12345.js to just modernizr.js.
  4. Move it to your asset pipeline folder, ideally vendor/assets/javascripts.
  5. Enjoy your custom build! :)

Contributing

  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

(The MIT license)

Copyright (C) 2011-2013 Russell Frisch (russfrisch)

See LICENSE.md.