/marionette-rails

Vendors the Backbone.Marionette library for use with Rails' asset pipeline

Primary LanguageRubyMIT LicenseMIT

marionette-rails

Dependency Status Gem Version

This gem is a wrapper for Derick Bailey's Backbone.Marionette library. It vendors the javascript library code for use with Rails' asset pipeline (Rails 3.1+).

This gem is currently maintained by @wingrunr21.

Dependencies

Backbone.Marionette depends on Backbone (and Backbone's dependencies). These dependencies are not currently managed by the marionette-rails gem directly, because there exists multiple options to use Backbone with the Rails asset pipeline, such as backbone-on-rails, backbone-rails, rails-backbone, just to name a few.

Usage

Add it to your Gemfile:

  gem 'marionette-rails'

Then add this to app/assets/javascripts/application.js.coffee after your backbone require:

#= require backbone.marionette

Or, if you are using pure javascript, add this to app/assets/javascripts/application.js:

//= require backbone.marionette

Versioning

The gem will mirror the Backbone.Marionette versioning scheme. That is, version 0.8.2.* of marionette-rails would vendor Backbone.Marionette v0.8.2.

Updating Backbone.Marionette

There are two rake tasks that aid with this process:

rake marionette:latest # => will fetch the latest Backbone.Marionette tag/SHA and print them
rake marionette:update # => will update the gem to the latest Backbone.Marionette js and update the gem version

Contributing

For bugs in Backbone.Marionette itself, head over to their issue tracker. If you have a question, post it at StackOverflow under the backbone.marionette tag.

For bugs in this gem distribution, use the GitHub issue tracker. If you could submit a pull request - that's even better!

License

This library is distributed under the MIT license. Please see the LICENSE file.