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.
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
.
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">
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">
For details on using BareKit, visit the website at a2labs.github.io/barekit
Copyright (c) 2014 appendTo LLC.
Dual licensed under the MIT or GPL licenses.