# file-icons-js

> File specific icons for the browser from Atom File-icons, https://github.com/file-icons/atom

Latest version **1.1.0** (published 2020-11-21) · MIT license · 0 weekly downloads

## Install

```sh
npm install file-icons-js
pnpm add file-icons-js
yarn add file-icons-js
bun add file-icons-js
```

## Health

**Score 20/100 (F)** — status: abandoned.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.0 |
| Published | 2020-11-21 |
| First published | 2017-03-27 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 524.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 89 |
| Author | Daniel Brooker. |
| Maintainers | websemantics |
| Keywords | javascript, nodejs, icons, octicons, mfizz, devicons |

## Links

- npm: https://www.npmjs.com/package/file-icons-js
- Repository: https://github.com/websemantics/file-icons-js
- Issues: https://github.com/websemantics/file-icons-js/issues
- npm.io page: https://npm.io/package/file-icons-js

## Alternatives

- [@fortawesome/react-fontawesome](https://npm.io/package/@fortawesome/react-fontawesome.md) — 2.2M weekly downloads
- [roboto-fontface](https://npm.io/package/roboto-fontface.md) — 196.0K weekly downloads
- [@react-native-vector-icons/common](https://npm.io/package/@react-native-vector-icons/common.md) — 150.4K weekly downloads
- [@procore/core-icons](https://npm.io/package/@procore/core-icons.md) — 4.6K weekly downloads
- [@react-md/material-icons](https://npm.io/package/@react-md/material-icons.md) — 1.6K weekly downloads

## Recent versions

- 1.1.0 (latest) — 2020-11-21
- 1.0.3 — 2017-09-18
- 1.0.2 — 2017-03-31
- 1.0.1 — 2017-03-28
- 1.0.0 — 2017-03-27

## README

```
╭───────╮                    ╭────╮
│    ╭──╯╭───╮╭───╮╭──────╮  ├────┤╭──────╮╭──────╮╭────┬─╮╭──────╮
│    ╰──╮├───┤│   ││  ──  │  │    ││   ╭──╯│   ╭╮ ││      ││  ────┤
│    ╭──╯│   ││   ││      │  │    ││   ╰──╮│   ││ ││   ╭╮ ││      │
│    │   │   ││   ││  ────┤  │    ││      ││   ╰╯ ││   ││ │├────  │
╰────╯   ╰───╯╰───╯╰──────╯  ╰────╯╰──────╯╰──────╯╰───╯╰─╯╰──────╯
╭─╮  ╭─╮  ┬─╮         ┬  ╭─╮  ┬  ┬  ╭─╮  ╭─╮  ╭─╮  ┬─╮  ┬  ╭─╮  ╭┬╮
├┤   │ │  ├┬╯         │  ├─┤  ╰╮╭╯  ├─┤  ╰─╮  │    ├┬╯  │  ├─╯   │
┴    ╰─╯  ┴╰─       ╰─╯  ┴ ┴   ╰╯   ┴ ┴  ╰─╯  ╰─╯  ┴╰─  ┴  ┴     ┴
```
> File specific icons for the browser from Atom File-icons, https://github.com/file-icons/atom

[![Hyperapp demo](https://img.shields.io/badge/File%20icons%20demo-%E2%86%92-9D6EB3.svg?style=flat-square)](https://websemantics.github.io/file-icons-js)


<img alt="Icon previews" width="850" src="https://raw.githubusercontent.com/file-icons/atom/6714706f268e257100e03c9eb52819cb97ad570b/preview.png" />

## Install

Use `npm` to install as follows,

```bash
npm i websemantics/file-icons-js
```

Or, `Bower`,

```bash
bower i websemantics/file-icons-js
```

## Getting Started

Include `css` styles from `css/style.css` in the header of an html document.

Get an instance of `FileIcons` class,

```js
var icons = window.FileIcons;
```

Get the class name of the icon that represent a filename (for example `text-icon`),

```js
var filename = 'src/app.js';
var class_name = icons.getClass(filename);
```

You can also get a class name of the associated icon color,

```js
var  filename = 'README.md';
var class_name = icons.getClassWithColor(filename);
```

Use the class name to generate html, for example,

```js
document.body.innerHTML = "<a><i class=" + class_name + "></i>$filename</a>";
```

## Resources

- [Atom File Icons](https://github.com/file-icons/atom), file specific icons for improved visual grepping.
- [Markdown Browser Plus](https://github.com/websemantics/markdown-browser-plus), Github flavoured, local file browser for markdown docs.

## Support

Need help or have a question? post at [StackOverflow](https://stackoverflow.com/questions/tagged/file-icons-js+websemantics).

*Please don't use the issue trackers for support/questions.*

*Star if you find this project useful, to show support or simply for being awesome :)*

## Contribution

Contributions to this project are accepted in the form of feedback, bugs reports and even better - pull requests.

## License

[MIT license](http://opensource.org/licenses/mit-license.php) Copyright (c) Web Semantics, Inc.

---
_Source: https://npm.io/package/file-icons-js · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._