# @icon/font-awesome
[](https://www.npmjs.org/package/@icon/font-awesome)
This repository is a module of the full [icon][icon] repository.
## Install
This repository is distributed with [npm]. After [installing npm][install-npm], you can install `@icon/font-awesome` with this command.
```bash
npm install --save @icon/font-awesome
```
## Usage
There are many ways/formats of how to use font-awesome. The fastest and recommended way is via SVG directly. Or use the webfont version if you want to include all icons at once:
### SVG icons -- when you need just a few icons in your project
1 . If you want to use just a few icons. Find the icons you need in "icons" folder. Then use them as regular images:
```
```
2 . Icons can be served from a CDN such as [Unpkg][Unpkg]. Simply use the `@icon/font-awesome` npm package in the URL like the following:
```
```
### Icons font -- ideal when you want to include all icons at once
1 . Install `@icon/font-awesome` with this command. In the `` of your html, reference the location to your `font-awesome.css`.
```
...
...
```
2 . Use [unpkg.com][Unpkg] to load directly font-awesome without installing anything:
```
...
...
```
> Place font-awesome with `` tag in your html like this. Icon class names are to be used with the `fa` class prefix.
```
```
## Bugs, Ideas, Pull Requests
If you have any ideas or found bugs, please send me Pull Requests or let me know with [GitHub Issues][github issues].
## License
Font-awesome is copyright by Dave Gandy. Font is licensed under the [SIL OFL 1.1][SIL]. CSS, LESS, and Sass files are licensed under the [MIT License][MIT]. Documentation is licensed under the [CC BY 3.0 License][CCBY3.0].
[CCBY3.0]: http://creativecommons.org/licenses/by/3.0/
[MIT]: https://opensource.org/licenses/mit-license.html
[SIL]: http://scripts.sil.org/OFL
[icon]: https://github.com/thecreation/icons
[npm]: https://www.npmjs.com/
[install-npm]: https://docs.npmjs.com/getting-started/installing-node
[sass]: http://sass-lang.com/
[github issues]: https://github.com/thecreation/icons/issues
[Unpkg]: https://unpkg.com
```
2 . Icons can be served from a CDN such as [Unpkg][Unpkg]. Simply use the `@icon/font-awesome` npm package in the URL like the following:
```
```
### Icons font -- ideal when you want to include all icons at once
1 . Install `@icon/font-awesome` with this command. In the `` of your html, reference the location to your `font-awesome.css`.
```
...
...
```
2 . Use [unpkg.com][Unpkg] to load directly font-awesome without installing anything:
```
...
...
```
> Place font-awesome with `` tag in your html like this. Icon class names are to be used with the `fa` class prefix.
```
```
## Bugs, Ideas, Pull Requests
If you have any ideas or found bugs, please send me Pull Requests or let me know with [GitHub Issues][github issues].
## License
Font-awesome is copyright by Dave Gandy. Font is licensed under the [SIL OFL 1.1][SIL]. CSS, LESS, and Sass files are licensed under the [MIT License][MIT]. Documentation is licensed under the [CC BY 3.0 License][CCBY3.0].
[CCBY3.0]: http://creativecommons.org/licenses/by/3.0/
[MIT]: https://opensource.org/licenses/mit-license.html
[SIL]: http://scripts.sil.org/OFL
[icon]: https://github.com/thecreation/icons
[npm]: https://www.npmjs.com/
[install-npm]: https://docs.npmjs.com/getting-started/installing-node
[sass]: http://sass-lang.com/
[github issues]: https://github.com/thecreation/icons/issues
[Unpkg]: https://unpkg.com