feathericon
v1.0.2
Published
Simple, scalable vector icon font for websites, apps.
Downloads
248
Maintainers
Readme
Getting Started
Basic
- Download ZIP folder from here.
- Copy the
css/
andfonts/
directory to your project. - In the
<head>
of your html, reference the location to yourfeathericon.min.css
.
<link rel="stylesheet" href="path/to/css/feathericon.min.css">
- Place feathicon with
<i>
tag in your html like this.fe
class is required to use our icons correctly. Check out our website to start using icons!
<i class="fe fe-heart"></i>
Using SVG sprite
- Download ZIP folder from here.
- Copy the
svg/sprite/sprite.feathericon.svg
to your project. - In your html, place like this. You can set specify any
width
,height
, andfill
with HTML attributes or CSS. Make sure put the icon name with hash after.svg
extension.
<svg width="16px" height="16px" fill="#0099cc" class="icon">
<use xlink:href="/<path-to-your>/sprite.feathericon.svg#heart"></use>
</svg>
.icon {
width: 16px;
height: 16px;
fill: #0099cc;
}
For developers
Node.js projects
$ npm install feathericon --save
or
$ yarn add feathericon
- Copy
fonts/
directory to your project.
$ cp -r node_modules/feathericon/build/fonts/ path/to/fonts
- You can simply point your Sass (SCSS)
include-path
at yournode_modules/
directory. This case is using gulp-sass.
gulp.task('sass', function () {
return gulp.src('path/to/*.scss')
.pipe(.sass({
loadPath : 'node_modules/feathericon/build/scss/',
outputStyle : 'compressed'
}).on('error', $.sass.logError))
.pipe(gulp.dest('path/to/css/'));
});
Then you can import it in your scss(sass) file.
@import "feathericon";
Ruby on Rails projects
You can install via RubyGems.
Repositories:
- feathericon-rails
- feathericon-sass ( using feathericon with Sass ).
Customize feathericon
1. Edit Sketch document
Open the Sketch document in src/feathericons.sketch
. Each icon exists as an artboard within the Sketch document. If you’re adding an icon, duplicate one of the artboards and add your shapes to it. Be sure to give your artboard a name that makes sense.
2. Update data.json
If you've added a new icon, you'll need to add a new entry and keywords for it in the data.json
.
3. Build icons
Requires
- Node.js
- npm
You can download from the Node.js download page, or install via package managers. Node.js comes with npm (See more).
- Open the
feathericon/
directory in Terminal. - Run this command to install dependencies for building icons.
$ npm run setup
- Run this command. Running the gulp task will generate the font, css, scss and SVGs, placing them in the
build/
directory.
$ npm run webfont
FontCustom
If you want to tweak font settings, edit fontcustom.yml
. feathericon is using FontCustom to build fonts, stylesheets such as feathericon.css
and _feathericon.scss
. If you need more information for FontCustom, visit their GitHub Repository.
Bugs, Ideas, Pull Requests
If you have any ideas or find bugs, please send me Pull Requests or let me know with GitHub Issues :)
License
MIT (C) 2018 Megumi Hano