easyxdm-rails is the easiest way to include easyXDM in your rail app.

Currently includes files from : easyXDM-


Add this to your Gemfile:

gem 'easyxdm-rails'

Then, of course, you need to run:

bundle install

Then you can add this to one of your js manifest files (like app/assets/javascripts/application.js)

//= require easyxdm-rails/easyXDM

Or if you're still in development mode, you may want to do this:

//= require easyxdm-rails/easyXDM.debug

Since you're using easyXDM, there's a good chance that you need to be able to serve easyXDM.js by itself, or in conjuction with your other scripts.

To serve it by itself you could add this to config/environments/production.rb

config.assets.precompile += %w( easyxdm-rails/easyXDM.js )

Then you could refer to :


Or you could create a new manifest, bookmarklet.js for example, in app/assets/javascripts and include both easyXDM.js and your code.

//= require easyxdm-rails/easyXDM
//= require your-bookmarklet-code.js

Then you could get both easyXDM and your code by refering to:



You can check the source for the easyxdm-rails-example project:


You can also see that project deployed here:


You can see easyXDM included in the application.js here:


And you can see it delivered by itself here:


This project rocks and uses MIT-LICENSE.