# Icon library by Icons8
> This repo is for distribution on `npm` and `bower`. The source for this module is in the [main i8-icon repo](https://github.com/icons8/i8-icon).
> Please file issues and pull requests against that repo.
**Insert the icons in 30 seconds using the new Icon Sets technology.**
## Installing i8-icon
You can install this package locally either with `npm`, `bower`, or `jspm`.
### npm
```shell
npm install i8-icon
```
Now you can use `require('i8-icon/angular-i8-icon')` or `require('i8-icon/jquery-i8-icon')` when installing with npm or jsmp and using Browserify or Webpack.
### bower
```shell
# To get the latest stable version, use bower from the command line.
bower install i8-icon
# To get the most recent, last committed-to-master version use:
bower install i8-icon#master
# To save the bower settings for future use:
bower install i8-icon --save
# Later, you can use easily update with:
bower update
```
> Please note that i8-icon requires **AngularJS 1.1.x** or higher for use as Angular module.
> Please note that i8-icon requires **jQuery 1.8.x** or higher for use as jQuery plugin.
## Using the i8-icon library
Simply include the scripts and stylesheet in your main HTML file, in the order shown in the example below. Note that npm will install the files under `/node_modules/i8-icon/` and bower will install them under `/bower_components/i8-icon/`.
### Simple demo for AngularJS version
```html
```
### Simple demo for jQuery version
```html
```
More demo [here](https://icons8.github.io/i8-icon/)
## Features
- Available all Icons8 [open source icons](https://github.com/icons8/flat-color-icons) via our api as default source.
- The icons are stored on our CDN server (which is free forever).
- You insert the icons right into your code.