Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

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

README.md

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 @chancancode and @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!

Donations

If you're using Marionette and you're finding that it is saving you time and effort, then please consider donating to the upstream Backbone.Marionette project.

Donate

License

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

Something went wrong with that request. Please try again.