# @icon/foundation-icons

[![npm version](https://img.shields.io/npm/v/@icon/foundation-icons.svg)](https://www.npmjs.org/package/@icon/foundation-icons)

This repository is a module of the full [standard-icons][standard-icons] repository.

## Install

This repository is distributed with [npm]. After [installing npm][install-npm], you can install `@icon/foundation-icons` with this command.

```bash
npm install --save @icon/foundation-icons
```

## Usage

There are many ways/formats of how to use foundation-icons. 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:

```
<img height="32" width="32" src="@icon/foundation-icons/icons/heart.svg" />
```

2 . Icons can be served from a CDN such as [Unpkg][Unpkg]. Simply use the `@icon/foundation-icons` npm package in the URL like the following:

```
<img height="32" width="32" src="https://unpkg.com/@icon/foundation-icons/icons/heart.svg" />
```

### Icons font -- ideal when you want to include all icons at once

1 . Install `@icon/foundation-icons` with this command. In the `<head>` of your html, reference the location to your `foundation-icons.css`.

```
<head>
...
<link rel="stylesheet" href="@icon/foundation-icons/foundation-icons.css">
...
</head>
```

2 . Use [unpkg.com][Unpkg] to load directly foundation-icons without installing anything:

```
<head>
...
<link rel="stylesheet" href="https://unpkg.com/@icon/foundation-icons/foundation-icons.css">
...
</head>
```

> Place foundation-icons with `<i>` tag in your html like this. Icon class names are to be used with the `fi` class prefix.

```
<i class="fi fi-heart"></i>
```


## 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

Foundation-icons is copyright by ZURB, licensed under the [MIT][license].

[license]: https://opensource.org/licenses/MIT
[standard-icons]: https://github.com/thecreation/standard-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/standard-icons/issues
[Unpkg]: https://unpkg.com

@icon/foundation-icons

@icon/foundation-icons

Install

Usage

SVG icons -- when you need just a few icons in your project

Icons font -- ideal when you want to include all icons at once

Bugs, Ideas, Pull Requests

License

Keywords