A simple, blogish software build with Sinatra and uses Git for data storage
Ruby JavaScript
Failed to load latest commit information.
articles/congratulations Moved views, public, and articles to the root. This will just make th… Oct 21, 2009
examples Adding 'examples' directory to store the intial templates and article… Oct 18, 2009
lib Add support for Markdown tables. Dec 28, 2011
MIT-LICENSE Initial import Mar 28, 2009
VERSION Updated the README with the new/change features. Jul 25, 2010
aerial.gemspec Use 1.x version of redcarpet for now. Dec 28, 2011



Aerial is a simple, blogish, web application written in Sinatra. Designed for developers, there is no admin interface and no SQL database. Articles are written in your favorite text editor and versioned with Git. Comments are handled by Disqus (http://disqus.com). It uses Grit (http://github.com/mojombo/grit) to interface with local Git repositories.

Aerial also comes with a static site generator. Why, you ask? Well, static pages offer a lot of benefits: First, static pages load lightning fast. It also allows web browsers to cache files much more efficiently due to Last-Modified headers and such.

Aerial can now run on Heroku! Initially, Aerial didn't work on Heroku since the .git directory is completely obliterated on each deployment. With static pages and little help from a couple Rack middleware plugins, getting Aerial on Heroku is a snap.

Aerial was designed for small personal blogs and simple static websites such as marketing sites. The main goals are to provide a no-fuss alternative with a basic set features.

Aerial is still in active development.


  • Pages and articles are managed thru git
  • Pages are represented in Haml templates
  • Articles are in Markdown format with embedded metadata
  • Comments are managed by Disqus (http://disqus.com)
  • Blog-like features: Recent Posts, Categories, Archives, and Tags
  • Static site generator
  • Works on Heroku!


$ gem install aerial
$ aerial install /home/user/myblog
# Navigate to <>

This will create a new directory and a few files, mainly the views, config files, and a sample article to get you started. Then, edit config.yml to your liking.

From Source

Aerial's Git repo is available on GitHub, which can be browsed at:


and cloned with:

$ git clone git://github.com/mattsears/aerial.git
$ rake launch
# Navigate to <>


  • sinatra (for awesomeness)
  • git (http://git-scm.com)
  • grit (interface to git)
  • yaml (for configuration)
  • rdiscount (markdown-to-html)
  • Haml (can easily be switch to erb, or whatever)


  • Improve bootstrap tasks
  • Add article limit setting to config.yml
  • Support atom feeds
  • Add support for including non article content (pages)
  • Add more details to this README


Aerial is Copyright © 2010 Matt Sears, Littlelines. It is free software, and may be redistributed under the terms specified in the MIT-LICENSE file.