/font-fabulous

A fabulous iconset packaged as a font

Primary LanguageSCSSApache License 2.0Apache-2.0

Font Fabulous

CI

Font Fabulous is a suite of pictographic icons for scalable vector graphics designed for the ManageIQ open-source Management Platform but available to everyone. Font Fabulous fills a gap not covered by other popular icon collections.

Installation

The package is available as a Rubygem, a Bower and an NPM package. The package name is for each the same: font-fabulous.

Usage

Simply include the (S)CSS file in your HTML code and create <i> elements with the desired CSS classes:

<i class="ff ff-tenant"></i>

You can find the supported icons under assets/images/font-fabulous, all the CSS classes are generated from the filenames.

Ruby on Rails

If installed as a gem, it is possible to include it to the Rails Asset Pipeline by adding the following lines into an scss file:

@import "font-fabulous-sprockets";
@import "font-fabulous";

Development

After checking out the repo, run bundle install to install dependencies. You might have to take a look at the installation instructions for the fontcustom gem.

You can add new icons as svg files into the assets/images/font-fabulous folder and run rake compile to generate the fonts.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in lib/font-fabulous/version.rb, bower.json and package.json, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, push the .gem file to rubygems.org and publish the NPM package.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/ManageIQ/Font-Fabulous. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the Apache License 2.0.