Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


What is it?

It is a command line application that allows you to create and run web sites built using haml, sass, jquery, and coffee-script. It also has support for markdown built right in. Give it a try, it only takes 5 minutes to get up and running.


  • haml

  • sass

  • coffee-script

  • markdown


At Jack Russell Software, we love haml, jquery, etc and needed to create web mockups or wireframes quickly to get user interface feedback during our storyboarding process. Mercury was the answer, it allows us to work with the same tools we are familar with and focus on getting the user interface right.

Simply type:

mercury {your project name}

And you are ready to start writing haml, sass, and jquery. No configuration or setup, just start creating.

To run a mercury app:

cd into your project folder and type:


Keeping it this simple allows users to start building right away!


gem install mercury

Create a mercury project

# Create a new folder for your project

mercury {project}

# Create your haml files

cd {project}

cd wwwroot

touch test.haml

# then create a haml page

touch test.haml

  %h1 Widget

%h1 Welcome to Mercury

  Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ut elit sapien, ultricies id pulvinar euismod, pharetra accumsan nisl. Phasellus at ante neque, ut gravida massa. Mauris dapibus dolor nec nibh pellentesque cursus. Nullam quis mauris sed augue tempus cursus at vel purus. Cras suscipit augue eget leo tincidunt tempus. Curabitur imperdiet risus et diam vestibulum dictum. Sed id erat quis tellus consectetur tristique sit amet ut orci. Phasellus malesuada dui sit amet tortor tincidunt quis molestie justo elementum. In hac habitasse platea dictumst. Suspendisse pharetra facilisis dolor ut tincidunt. Donec rhoncus viverra sem, eu lobortis eros facilisis eu. Nam fringilla vehicula diam gravida consectetur. Donec tincidunt, diam sed pharetra accumsan, urna quam malesuada nibh, id malesuada mauris est vel mauris. Proin lacus magna, facilisis vel pulvinar sed, suscipit malesuada metus. Nam semper mattis pharetra. Quisque et mattis eros.

Run Server

# cd back to the root directory

cd ..

# run


# now navigate to localhost:9292

And you should see you index page with a link to your test.haml form

Using Sass

# Create your sass file

!x = blue
  color = !x

# save test.sass

# now in your haml file simply 

= sass :test

Using Javascript

# Create you js file

$(function() {
  alert('this rocks!');

# save test.js

# now in your haml file simply

= javascript :test

Note on Patches/Pull Requests

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don't break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)

  • Send me a pull request. Bonus points for topic branches.

Copyright © 2010 Jack Russell Software Company. See LICENSE for details.


Quickly create Haml, Sass, JQuery Web Sites.







No releases published


No packages published