yangchengit / barekit

A bare minimum responsive framework

Home Page:a2labs.github.io/barekit

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

BareKit

BareKit is a front-end project starter meant to be a starting point and structural guide rather than a full framework. It's bare enough to not interfere with your custom styles or scripts, but yet has enough functioning modules to jumpstart a project in no time.

This project is part of appendTo Labs where our team can release open source projects spearheaded by developers within appendTo. While not officially maintained by appendTo, we are excited to provide this platform to share our team’s creations with the open source community around the world.

The project creator and lead for Barekit is Trevan Hetzel (trevanhetzel) . Use Github issues and pull requests or reach out to Trevan directly for support and contributions to Barekit.

Getting Started

The best way to get BareKit up and running on a project is to install via Bower. You shouldn't ever touch the source anyway, so with Bower it's easy to get the latest updates.

First, make sure you have Bower installed. Then you can add this line to a bower.json file "barekit": "~0.5.0" or simply do a bower install barekit.

JavaScript

Getting up and running with the BareKit JavaScript modules is very simple. You first need to reference the latest jQuery file (also installable via Bower), and then reference the barekit.min.js file at the bottom of your HTML page (before the closing body tag).

If you installed jQuery and BareKit using Bower, the paths would look something like this:

<script src="bower_components/jquery/dist/jquery.min.js">
<script src="bower_components/barekit/js/barekit.min.js">

CSS

The BareKit CSS can be used in a few different ways. The core code comes with both a Sass and Stylus version, so the ideal way is to @import the barekit.scss or barekit.styl file from your main Sass or Stylus stylesheet.

Again, if you installed via Bower, the @import rule would look something like this:

// Import BareKit
@import "bower_components/barekit/css/barekit";

Using BareKit in this way allows you to compile it using your own preferred pre-processor, task runner, compression style, etc.

The other way to use the BareKit CSS is, of course, to just reference it directly in your markup.

<link rel="stylesheet" href="bower_components/barekit/css/barekit.css">

Usage

For details on using BareKit, visit the website at a2labs.github.io/barekit

License

Copyright (c) 2014 appendTo LLC.

Dual licensed under the MIT or GPL licenses.

http://appendto.com/open-source-licenses

About

A bare minimum responsive framework

a2labs.github.io/barekit