Mechanic creates engines the Group Buddies way. It's perfect if you just want to hit the groud running and not worrying on doing those same configuration steps everytime.


Add this line to your application's Gemfile:

gem 'mechanic'

And then execute:

$ bundle

Or install it yourself as:

$ gem install mechanic


TODO: Write usage instructions here


Some gems included in Mechanic have native extensions. You should have GCC installed on your machine before generating an app with Mechanic.

Use OS X GCC Installer for Snow Leopard (OS X 10.6).

Use Command Line Tools for XCode for Lion (OS X 10.7) or Mountain Lion (OS X 10.8).

We use Capybara Webkit for full-stack Javascript integration testing. It requires QT. Instructions for installing QT are here.

PostgreSQL needs to be installed and running for the db:create rake task.


If you have problems, please create a Github Issue.


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request



Mechanic is maintained and funded by GB - Software As A Service, Lda.

Mechanic's idea came from thoughtbot's suspenders, so some of the code is based on it.


Mechanic is Copyright © 2008-2012 Group Buddies. It is free software, and may be redistributed under the terms specified in the LICENSE file.