simcn / refills

Components and patterns built with Bourbon and Neat

Components and patterns built with Bourbon and Neat

• Examples & Code Snippets
• Changelog
• Issues & Bugs

Follow the @bourbonsass Twitter account for updates.

Requirements

• Sass 3.3+
• Bourbon 4.0+
• Neat 1.6+

Installation

1. Install Refills’ dependencies: Bourbon, Neat and jQuery (if you plan to use any components that require JavaScript).

2. Go to the Refills website, click “Show Code” under the component or pattern that you want and copy-paste it into your project.

3. Customize: Most of the components and patterns have a set of Sass variables that allow you to quickly tweak the look and feel.

Installation for Ruby on Rails

Alternative to copy-pasting manually, we also have a Refills gem that allows you to add components and patterns via Rake tasks.

1. Add Refills to your Gemfile:

gem 'refills'

2. Then run:

bundle install

3. Use the following Rails generators:

List all available snippets:

rails generate refills:list

Add a snippet:

rails generate refills:import SNIPPET

If you want to generate coffeescript instead of javascript, simply add --coffee

rails generate refills:import SNIPPET --coffee

This copies the snippet’s partial to app/views/refills, the stylesheet to app/assets/stylesheets/refills and the JavaScript to app/assets/javascripts/refills

Miscellaneous

If your css reset file does not add webkit antialias, add the following code to your Scss file:

body {
  -webkit-font-smoothing: antialiased;
}

The Bourbon family

• Bourbon: A simple and lightweight mixin library for Sass
• Neat: A lightweight semantic grid framework for Sass and Bourbon
• Bitters: Scaffold styles, variables and structure for Bourbon projects
• Refills: Components and patterns built with Bourbon and Neat

License

Copyright © 2014–2015 thoughtbot, inc. Refills is free software, and may be redistributed under the terms specified in the license.

Whenever code for Refills is borrowed or inspired by existing code, we try to credit the original developer/designer in our source code. Let us know if you think any credit is absent.

About thoughtbot

Refills is maintained and funded by thoughtbot, inc. The names and logos for thoughtbot are trademarks of thoughtbot, inc.

We love open source software! See our other projects or hire us to help build your product.