Generate Html5 Boilerplate for your Rails apps!
Ruby JavaScript CoffeeScript
Failed to load latest commit information.
lib Use double equals in slim templates for rendering Apr 13, 2013
test Generate more logically organized stylesheets directory Apr 7, 2013
vendor/assets/javascripts Upgrade modernizr and js asset cleanup Apr 6, 2013
.gitignore Update to rails 3.2.9 Nov 29, 2012
Gemfile Upgrade to rails 3.2.13 Apr 3, 2013
LICENSE Readme typos and file rename Dec 8, 2011 Readme updates Apr 7, 2013
Rakefile A dummy rails app to test with Jun 24, 2011
html5-rails.gemspec Relaxed railtie version for Rails 4 Apr 4, 2013

Html5 for Rails

Html5 for Rails projects based on Html5 Boilerplate by Paul Irish, Divya Manian and many other fine folks.


1. In your Gemfile
group :assets do
  gem 'sass-rails'
  gem 'coffee-rails'
  gem 'uglifier'

  gem 'compass-h5bp'

gem 'jquery-rails'
gem 'html5-rails'

# Optional: to generate haml
# gem 'haml-rails'

# Optional: to generate slim
# gem 'slim-rails'
2. Install your bundle
$ bundle install
3. Run the generator
$ rails generate html5:install
(Here's what it does)
  create  config/compass.rb
  create  config/html5_rails.yml
  create  app/views/layouts/application.html.(erb|haml|slim)
  create  app/views/application
  create  app/views/application/_footer.html.(erb|haml|slim)
  create  app/views/application/_head.html.(erb|haml|slim)
  create  app/views/application/_header.html.(erb|haml|slim)
  create  app/views/application/_chromeframe.html.(erb|haml|slim)
   exist  app/assets/javascripts
  insert  app/assets/javascripts/application.js
    gsub  app/assets/javascripts/application.js
  create  app/assets/javascripts/polyfills.js
  remove  app/assets/stylesheets/application.css
  create  app/assets/stylesheets/application
  create  app/assets/stylesheets/application/index.css.scss
  create  app/assets/stylesheets/application/variables.css.scss
  create  app/assets/stylesheets/application/layout.css.scss
  create  app/assets/stylesheets/application/media_queries.css.scss
4. And you're done!
  rails server


To see other generators available run:

$ rails generate html5:layout --help
$ rails generate html5:partial --help
$ rails generate html5:assets --help

Google Analytics

By default your Google Analytics code snippet will be hidden until you set your Google Account ID. You can do this by either setting ENV['GOOGLE_ACCOUNT_ID'] or google_account_id in config/html5_rails.yml.


[1] The compass-h5bp gem is not a runtime dependency, but it does need to be included in your assets group for development and asset precompiling to work.

[2] If you use --template-engine=haml (or haml-rails gem), the install generator will prompt to remove your application.html.erb layout so that application.html.haml will be used instead.

[3] For the time being, you will want to add the following line to config/production.rb so that polyfills are precompiled on deploy:

config.assets.precompile += %w( polyfills.js )


Copyright (c) 2010-2013 Peter Gumeson. See LICENSE for full license.