It's a flat, fast and powerful front-end framework for rapid web development.
CSS JavaScript CoffeeScript Ruby
Latest commit aae1081 Jun 11, 2016 @thelastinuit thelastinuit Er... wrong dir
Failed to load latest commit information.
coffee Fixes the modal not picking up the correct configuration through data… Oct 22, 2014
dist Adds compiled versions for version 3.1.1 Jul 27, 2015
docs Adds compiled versions for version 3.1.1 Jul 27, 2015
docs_scss Adds border to alpha buttons for landing Sep 4, 2014
fontawesome Adds font awesome as assets for documentation Jan 27, 2014
img Updates the look and feel for the documentation Sep 4, 2014
js Fixes the modal not picking up the correct configuration through data… Oct 22, 2014
scss Updates build with new compass version (1.0.3) Apr 17, 2015
.codeclimate.yml Er... wrong dir Jun 11, 2016
.gitattributes Adds gitattributes to force end lines on unix Jan 23, 2014
.gitignore Adds humans and robots txt template to the ignore file Feb 14, 2014
.ruby-version Adds jekyll to the Gemfile for easy installation Nov 28, 2014
CHANGELOG.md Adds changes from version 3.0.2 to 3.0.3 May 28, 2014
Gemfile Adds sass gem to the Gemfile Apr 17, 2015
Gemfile.lock Adds sass gem to the Gemfile Apr 17, 2015
Gruntfile.js Updates the look and feel for the documentation Sep 4, 2014
LICENSE Updates the license from apache to MIT Jan 23, 2014
README.md added CC badges Apr 17, 2016
USING_FURATTO.md Updates all version number from configuration files May 28, 2014
_config.yml Adds sass gem to the Gemfile Apr 17, 2015
bower.json updates assets to new furatto version Oct 22, 2014
package.json Updates the version for the package for bower Apr 17, 2015

README.md

Furatto

Gitter Code Climate Issue Count

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:

http://icalialabs.github.io/furatto/

Table of contents

Quick start

Using Furatto is extremely easy, we've provided three quick start options:

  • Download the latest release.
  • Clone the repo: git clone git@github.com: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.

Bug tracker & feature request

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.

Documentation

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.

Running documentation locally

  1. You need to install Jekyll or run bundle install
  2. From the root of the project furatto/ run jekyll serve --watch from the command line, this way if you change any file jekyll will generate that for you.
  3. 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.

Old 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.

Compiling CSS and JavaScript

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:

Installing Grunt

From the command line:

  1. Install grunt-cli globally with npm install -g grunt-cli.
  2. Navigate to the root /furatto directory, then run npm 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

Available Grunt tasks

Some of the grunt tasks are:

Build - grunt

This task will build the whole framework, which means, sass compilation, coffeescript compilation, dist directory creation, compression of files and more.

Workflow

We have a very useful workflow to work with Furatto and Grunt:

  1. Run jekyll serve --watch from the command line on the root folder furatto/
  2. 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

Using Rails?

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

Contributing

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!

Community

Keep track of new feautres, development issues and community news.

Using Furatto?

We will love to hear wheter you are using Furatto for testing, prototyping or online sites, checkout who is in already here

Heroes

Abraham Kuri

Copyright and license

Code and documentation copyright 2013-2014 Icalia Labs. Code released under the MIT license.