![Gitter](https://badges.gitter.im/Join Chat.svg)
Furatto is a lightweight & friendly front-end framework got get the job done, created and maintained by Abraham Kuri from Icalia Labs.
To get started, checkout:
- Quick start
- Bug tracker & feature request
- Documentation
- Compiling CSS and Javascript
- Using Rails
- Contributing
- Community
- Using Furatto
- Heroes
- License
Using Furatto is extremely easy, we've provided three quick start options:
- Download the latest release.
- Clone the repo:
git clone [email protected]:IcaliaLabs/furatto.git
. - Install via bower:
bower install furatto
.
We recommend you read the Getting started guide for information about the contents, caveats and more.
Have a bug or a feature request? Please open a new issue. Before opening any issue, please search for existing issues.
We recommend you to read the version milestiones if you feel like want to collaborate.
Furatto's documentation is built using Jekyll and publish thorugh Github pages at http://icalialabs.github.io/furatto/. You should be able to run them locally.
- You need to install Jekyll or run
bundle install
- From the root of the project
furatto/
runjekyll serve --watch
from the command line, this way if you change any file jekyll will generate that for you. - Open http://localhost:9001/furatto and you are good to go.
Jekyll is a great way to work with static pages, we definitely recommend you take a look at the documentation.
We still provide support for version 1 and 2 as it is a big change from one to another, you can visit the old docs V1 and V2.
We encourage you to migrate to version 3 as is a more stable, friendly and extendable version.
Furatto V3 now uses Grunt to compile all the Sass code and start working with the framework. Before getting started you need to add the necessary dependencies:
From the command line:
- Install
grunt-cli
globally withnpm install -g grunt-cli
. - Navigate to the root
/furatto
directory, then runnpm install
. npm will look at package.json and automatically install the necessary local dependencies listed there.
If you need to install npm, or you are not quite sure what it is, here is a quick link for you to get started. NPM
Some of the grunt tasks are:
This task will build the whole framework, which means, sass compilation, coffeescript compilation, dist directory creation, compression of files and more.
We have a very useful workflow to work with Furatto and Grunt:
- Run
jekyll serve --watch
from the command line on the root folderfuratto/
- In another terminal run
grunt watch
, which will be pending of any change on any coffeescript or sass file. It will compile everything up and deliver it to Jekyll, which by receiving the change will regenerate the necessary files.
We also include livereload to reload when the watch task is over, for more info refer to the our Gruntfile
A gem to integrate with Furatto is well maintain by @kurenn, this will help you start coding your front end right away. Here is the gem
Please submit all pull requests against a separate branch. Please follow the standard for naming the variables, mixins, etc.
In case you are wondering what to attack, we hnow have a milestone with the version to work, some fixes and refactors. Feel free to start one.
Thanks!
Keep track of new feautres, development issues and community news.
- Follow @furattoicalia
- Have a question about anything, email us at [email protected]
We will love to hear wheter you are using Furatto for testing, prototyping or online sites, checkout who is in already here
Abraham Kuri
Code and documentation copyright 2013-2014 Icalia Labs. Code released under the MIT license.