Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Glue framework.

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin
Octocat-spinner-32 lib
Octocat-spinner-32 test
Octocat-spinner-32 .gitignore
Octocat-spinner-32 CHANGELOG
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.markdown
Octocat-spinner-32 Rakefile
Octocat-spinner-32 monk.gemspec
Octocat-spinner-32 monk.gemspec.erb
README.markdown

Monk

Monk is a glue framework for web development.

It means that instead of installing all the tools you need for your projects, you can rely on a Git repository, and Monk takes care of the rest. By default, it ships with a Sinatra application that includes Cutest, Stories, Webrat, Ohm and some other niceties, along with a structure and helpful documentation to get your hands wet in no time.

But Monk also respects your tastes, and you are invited to create your own versions of the skeleton app and your own list of dependencies. You can add many different templates (different git repositories) and Monk will help you manage them all.

Installation

Ensure that RVM is installed. If it isn't, use:

$ bash < <( curl http://rvm.beginrescueend.com/releases/rvm-install-head )

Install the Monk gem:

$ gem install monk

For more information on RVM, see the RVM website.

Usage

Once monk is installed, create your first project:

$ monk init myapp

Try it out, and install the necessary gems:

$ cd myapp
$ monk install

Run the included test suite: (optional but recommended)

$ rake

If the tests pass, it means that you can start hacking right away. If they don't, just follow the instructions.

You may then start the web server:

$ monk start

You can access your site at http://localhost:4567.

As the default skeleton is very opinionated, you will probably need to install and run Redis, a key-value database.

Something went wrong with that request. Please try again.