tikitdo / bower-rails

rake tasks for bower on rails

bower-rails

rake tasks for bower on rails. Dependency file is bower.json in Rails root dir.

Asset Pipeline

As of version 0.3.0 bower-rails installs components in the asset directory, rather than assets/javascripts. This is because some of these packages also include stylesheets, or images. As such you may have to add components to your asset pipeline.

  # config/application.rb

  config.assets.paths << Rails.root.join("lib", "assets", "components")
  config.assets.paths << Rails.root.join("vendor", "assets", "components")

Requirements

• node (on github)
• bower (>= 0.9) installed with npm

Install

in Gemfile

	gem "bower-rails", "~> 0.3.1"

Initialize

To add an empty bower.json file to the project root.

	rails g bower_rails:initialize

##JSON configuration

The bower.json file is two seperate bower component.js files. Defining a package in lib and vendor will install those packages to the corresponding directories.

example bower.json file

{
   "lib": {
    "dependencies": {
      "threex"      : "[email protected]:rharriso/threex.git",
      "gsvpano.js"  : "https://github.com/rharriso/GSVPano.js/blob/master/src/GSVPano.js"
    }
  },
  "vendor": {
    "dependencies": {
      "three.js"  : "https://raw.github.com/mrdoob/three.js/master/build/three.js"
    }
  }
}

Available commands

  rake bower:install #install js components
  rake bower:update  #update js components

##Ruby DSL configuration

The Ruby DSL configuration is a Jsfile with DSL syntax similar to Bundler

Example Jsfile

assets_path "assets/javascript"

# Puts files under ./vendor/assets/js
group :vendor, :assets_path => "assets/js"  do
  js "jquery"            # Assummes it's latests
  js "backbone", "1.2"
end

# Puts files under ./lib/assets/javascript
group :lib do
  js "jquery"
  js "backbone", "1.2"
end

Available commands with a Jsfile

  rake bower:dsl:install #install js components
  rake bower:dsl:update  #update js components