gistfile1.md

TODO: make gem for this

This was tested using Rails 3.2 and Rails 4.0 on Ruby 2.0.0.

Bower

1. Set the install directory for Bower components:

   // .bowerrc
   {
     "directory": "vendor/assets/components"
   }

2. Follow the Bower instructions and create a bower.json file in your directory with your dependencies, e.g.

   // bower.json
   {
     // ...
     "dependencies": {
       "d3": "~3.1.0",
       "underscore": "~1.4.4",
     }
   }

3. Include them in your JavaScript:

   # config/application.rb
   
   # include Bower components in compiled assets
   config.assets.paths << Rails.root.join('vendor', 'assets', 'components')

   // /Users/aidan/dev/code_cruise/app/assets/javascripts/application.js
   //
   // Bower packages
   //= require d3/d3
   //= require underscore/underscore
   //
   //= require jquery
   //= require jquery_ujs
   // ...

4. Ignore the components in your repo.

   # .gitignore
   /vendor/assets/components
   

5. Install the componenets.

   npm install -g bower
   bower install

It's just that easy!!! ::facepalm::

Additional resources:

• http://dev.af83.com/2013/01/02/managing-rails-assets-with-bower.html
• http://kaeff.net/posts/sprockets-bower-better-component-packaging-for-rails-asset-pipeline.html