Support Libraries

There are libraries out there that I think are doing cool things. I would like to support many of them, and this page provides information about how to include them in your own project, and how to use them.

In general, since there's two ways to use Mercury, there's two ways to include supported libraries. If you're using the mercury loader, just include it in your own javascript include tags. If you're using the Rails stack you should just require it in your mercury.js file so we know it's being used.

Your requires should look something like:

*= require_self
*= require mercury/support/history
* -- more support libraries --
*= require mercury/mercury

History.js

https://github.com/balupton/History.js

You might want to have all sorts of cool ajax loading, transitions, and because of that you may need history support on your site. The history.js project is pretty awesome, so we encourage you to use it. We've integrated it into Mercury so it's pretty easy to drop in and have it work.

There's a bundled version of the native adapter currently, but you can use whichever one you want, just require it in mercury.js if you're using the Rails stack, or include it in your html if you're using the mercury loader.