torba-rails

This gem provides integration for Ruby on Rails projects with the Torba gem.

Status

Production ready.

Documentation

Released version

Installation

Add this line to your application's Gemfile and run bundle:

gem 'torba-rails'

Usage

The gem doesn't need extra configuration except the usual Torba setup.

Non JS/CSS assets are automatically added to precompile list, no need to manually populate config.assets.precompile.

Be careful to import only assets that you really need. Everything that is non JS or CSS asset is going to be precompiled by Sprockets and accessible publicly. See Rails ticket that explains this problem (and why Rails >= 4 precompiles only application.js/css in vendor by default), except that Torba does have a way to specify exact list of files to import.

Example

See fully configured Rails application.

Deployment

torba-rails automatically hooks into the existing assets:precompile Rake task to ensure that torba pack is executed. This means that Rails deployments will "just work", although there are some optimizations you can make as explained below.

Heroku

You will need to specify some config vars to ensure Torba's files are placed in locations suitable for the Heroku platform.

TORBA_HOME_PATH should be within your app so that Torba's assets are included in the slug.

TORBA_CACHE_PATH should make use of the tmp/cache/assets directory. This is where the Ruby buildpack expects cached files to be stored related to the assets:precompile step. This way Torba doesn't have to download packages fresh every time.

heroku config:set TORBA_HOME_PATH=vendor/torba TORBA_CACHE_PATH=tmp/cache/assets/torba

Now your Heroku app is good to go.

Capistrano

Specify the TORBA_HOME_PATH env variable pointing to a persistent directory writable by your deploy user and shared across releases. Capistrano's shared directory is good for this.

For Capistrano 3, you can set this up in config/deploy.rb:

set :default_env, { torba_home_path: shared_path.join('vendor/torba') }