Before anything else I’d suggest taking a look at thoughtbot’s Backbone.js on Rails book, which is a great starting point, although aimed at an intermediate to advanced audience. I bought this book having already worked with rails but as a total backbone.js beginner and it has served me very well.
Beyond that, there are some fundamental issues with combining these frameworks which go beyond the details covered in this book and other books. Below are some things I’d suggest you think about, from my own experiences pairing RoR and backbone.js. This is a long answer and strays a bit from the specifics of your question, but I hope it might help you out in the “big picture” sense of understanding the problem you’re facing.
Rails: Web Framework vs API
The first thing you confront when using backbone.js on top of a rails application is what to do about views, but this is really just the surface of a much deeper issue. The problem goes to the very heart of what it means to create a RESTful web service.
Rails is set up out of the box to encourage its users to create RESTful services, by structuring routing in terms of a set of resources accessed at uniform URIs (defined in your
routes.rb file) through standard HTTP actions. So if you have a
Post model, you can:
- Get all posts by sending
- Create a new post by sending a
/posts/new, filling out the form and sending it (a
- Update a post with id
123by sending a
/posts/123/edit, filling out the form and sending it (a
- Destroy a post with id
123by sending a
The key thing to remember about this aspect of Rails is that it is fundamentally stateless: regardless of what I was doing previously, I can create a new
Post simply by sending a
POST request with a valid form data to the correct URI, say
/posts. Of course there are caveats: I may need to be logged in (have a session cookie identifying me), but in essence Rails doesn’t really care what I was doing before I sent that request. I could follow it up by updating another post, or by sending a valid action to whatever other resources are made available to me.
Backbone.js: A new stateful layer
Backbone is also based on RESTful resources. Whenever you create, update or destroy a backbone.js model, you do so via the standard HTTP actions sent to URIs which assume a RESTful architecture of the kind described above. This makes it ideal for integrating with RESTful services like RoR.
But there is a subtle point to be stressed here: backbone.js integrates seamlessly with Rails as an API. That is to say, if you strip away the HTML views and just use Rails for serving RESTful resources, integrating with the database, performing session management, etc., then it integrates very nicely with the structure that backbone.js provides for client-side code. Many people argue that there’s nothing wrong with using rails this way, and I think in many ways they are right.
The complications arise though from the issue of what to do with that other part of Rails that we’ve just thrown away: the views and what they represent.
Stateful humans, stateless machines
This is actually more important than it may initially seem. HTML views represent the stateless interface that humans use for accessing the RESTful resources your service provides. Doing away with them leaves you with two access points:
- For humans: a rich, client-side interface provided by the backbone.js layer (stateful)
- For machines: a resource-oriented RESTful API provided by the rails layer (stateless)
Notice that there is no longer a stateless (RESTful) interface for humans. In contrast, in a traditional rails app with an API, we had something closer to this:
- HTML resources for humans (stateless)
- JSON/XML resources (API) for machines (stateless)
The latter two interfaces for accessing resources are much closer in nature to each other than the previous two. Just think for example of rails’ respond_with, which takes advantage of the similarities to wrap various RESTful responders in a unified method.
This might all seem very abstract and beside the point, I know. To try to make it more concrete, consider the following problem, which gets back to your question about getting rails and backbone.js to work together. In this problem, you want to:
- Create a web service with a rich client-side experience using backbone.js, with rails as the back end serving resources in JSON format.
pushStateto give each page in the app a URL (e.g.
/posts/123) which can be accessed directly (by entering it into the browser bar).
These are not unusual demands for a modern web service, but they create a complex challenge. To make a long story short, you now have to create two “human-oriented” layers:
- Stateful client-side interface (backbone.js templates and views)
- Stateless HTML resources (Rails HTML views)
The complexity of actually doing this leads many nowadays to abandon the latter of these two and just offer a rich client-side interface. What you decide to do depends on your goals and what you want to achieve, but it’s worth thinking about this problem carefully.
As another possible reference for doing that, I’d suggest having a look at O’Reilly’s RESTful Web Services. It might seem odd to be recommending a book on REST in a question about Rails and Backbone.js, but actually I think this is the key piece that fits these very different frameworks together, and understanding it more fully will help you take advantage of the strengths of both.