Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

mustache_rails3 provides a template handler and generators for Rails 3.

branch: master

This branch is 0 commits ahead and 0 commits behind master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 config
Octocat-spinner-32 lib
Octocat-spinner-32 LICENSE
Octocat-spinner-32 mustache_rails3.gemspec

Mustache support for Rails 3

This generator and template handler for Mustache in Rails 3 is based on the work of Paul Barry, Louis T., and Martin Gamsjaeger. I am indebted to them for allowing me to stand on their shoulders.

This is also available as a rubygem.

I'm just getting started. This really is a low-numbered prerelease. :-) I have asked for comments on the mustache project's Rails Support issue ticket. Please leave feedback there, and thanks.

Views & Templates

For your view files, subclass Mustache::Rails as (:controller)::(:action) in app/views/:controller/:action.rb


class Home::Index < Mustache::Rails
  def world
    'New Caprica'

Mustache::Rails registers a TemplateHandler for ".rb" files. Templates go in app/templates/:controller/:action.format.mustache


Hello {{world}}!


Layouts work much the same way, using a similar naming convention. Subclass Mustache::Rails as Layouts::(:layout) in app/views/layouts/:layout.rb


class Layouts::Main < Mustache::Rails
  def default_title
    'A Cylon fleet has jumped into orbit!'

Place the template for your layout in app/templates/layouts/:layout.format.mustache




A Rails 3 reminder: be sure to add

gem 'mustache'

to your project's Gemfile before running any generators or starting the server.

If you're using the mustache_rails3 gem, be sure to also add

gem 'mustache_rails3'

You can enable the mustache template handler by running

rails g mustache:install

in your project directory.


Something went wrong with that request. Please try again.