mercury

mercury

Front End Bundle - SASS, Jekyll, Compass, Grunt

Mercury

Mercury is a front end asset framework which uses SASS, Compass, Jekyll, Ruby, NPM, Bower, Grunt, jQuery, CSS3 Transitions, and HTML5. Pre built for rapid prototyping and mobile first design it takes the pain and frustration out of starting out a project for blazing deployments. Responsive out of the box and scalable, it's lighting fast UI (based on yahoo's PURE.io framework) converts static assets into a static directory that is easily integrated with any back end. If you are interested in the future of the web and want to contribute feel free to fork away!

#Install Dependencies

##Install Gems

$ gem install jekyll
$ gem install jekyll-compass
$ gem install rdiscount
$ compass init

###NPM Install

$ npm install

###Bower Components $ bower install

###Start with Grunt:

$ grunt

###You are now up and running!

===> Now point to http://localhost:4000

Mercury is mainly built on the Jekyll Platform and integrates easily into any Git workflow. It uses PURE from yahoo instead of Bootstrap because it's much smaller footprint makes it light and easy to work with. If you are comfortable with Git as well as NPM, Bower and SASS this project can be a boiler-plate that you will fall in love with.

##Basic Jekyll Structure:


├── _config.yml
├── _drafts
|   ├── begin-with-the-crazy-ideas.textile
|   └── on-simplicity-in-technology.markdown
├── _includes
|   ├── footer.html
|   └── header.html
├── _layouts
|   ├── default.html
|   └── post.html
├── _posts
|   ├── 2007-10-29-why-every-programmer-should-play-nethack.textile
|   └── 2009-04-26-barcamp-boston-4-roundup.textile
├── _data
|   └── members.yml
├── _site
└── index.html

##Require any additional compass plugins here.

config/compass.rb

###Options:

Bower:

add_import_path "bower_components"

Google Fonts:

add_import_path "http://fonts.googleapis.com/css?"

#####Set this to the root of your project when deployed:

Path:

http_path = "/"

CSS:

css_dir = "/css"

SASS:

sass_dir = "/_sass"

Images:

images_dir = "img"

JS:

javascripts_dir = "js"

##Boundary

A boundary refers to a block that is at the highest level in the DOM tree. All of its children will be able to reset their block dimension in ratio to this parent block's declaration. This is useful when defining small area's with meaningful and targeted content. Declares an area that exists as constant to another area.

<section class="boundary-three line-two">
    You're new boundary area.
</section>

####Boundary

This class uses units of 1-5.

Calculation: $base-width: percentage(64/320);

Example: .boundary-two { width: $base-width * 2 }

####Line

This class uses units of 1-8.

Calculation: $base-height: percentage(80/480);

Example: .line-two { height: $base-height * 2 }

####Edge

Standard presentation box with paddings and margins.

.edge {
    margin: 3.35% 5.35%;
    padding: 5.35% 3.35%;
}

###Based upon the following open source projects:

jekyll logo

Want a Jekyll website built?

Hire a Jekyll developer