built and supported by Alfa Jango

visit alfajango.com » « view all open source projects

Sinatra MVC

Sinatra with an MVC Tune

A boilerplate Sinatra app with models and views separated from the main app, and ready to deploy to Heroku.

Heroku Sinatra MVC

I love Sinatra for writing quick and easy web apps in a snap. I also love MVC for keeping code clear, organized, and easily testable.

This is a template Sinatra app with some MVC-oriented configurations and testing built in.


Models are located in config/data.rb. For small apps, it's usually convenient enough to just put all models into that file. Though it's easy to separate each model into its own file. See the file for example model structure.

Depending on the database and ORM adapter being used, you may need migrations. Migrations can be found in config/migrations.rb. See the file for example migrations.

This app uses Postgresql for production (to work easily on Heroku), with Sequel ORM, which is similar to ActiveRecord, for those familiar with Rails.


Sinatra conveniently combines the controller functionality in with the routing. This is all in the usual my_app.rb file.


Each view has its own file in the views directory. This app uses haml for templating, though this can easily be switched out with erb or whatever you want.


Images, JavaScripts, and CSS are located together in the public directory.


This app is configured to use RSpec for testing, with tests located in the spec directory.

Getting Started

There is no installation script or magic involved. Just fork this project and start coding.

You might consider adding this fork as a git remote to easily pull down and merge updates with your app:

git remote add template git://github.com/JangoSteve/heroku-sinatra-app.git

Sample App

For a sample app using this template, see The Aceys.

Deployment to Heroku.

Sinatra and Heroku Notes

The small amount of code is heavily commented. If you have questions or comments please use the channels provided by the Sinatra community as we at Heroku are heavily involved in Sinatra. Please use the Heroku mailing list if you have non Sinatra questions.

See these guidelines for contributing or bugs.