# emoji-toolkit

> JoyPixels is a complete set of emoji designed for the web. The emoji-toolkit includes libraries to easily convert unicode characters to shortnames (:smile:) and shortnames to JoyPixels emoji images. PNG formats provided for the emoji images.

Latest version **11.0.0** (published 2026-08-03) · MIT license · 0 weekly downloads

## Install

```sh
npm install emoji-toolkit
pnpm add emoji-toolkit
yarn add emoji-toolkit
bun add emoji-toolkit
```

## Health

**Score 45/100 (D)** — status: active.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 11.0.0 |
| Published | 2026-08-03 |
| First published | 2019-04-17 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 6.3 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 472 |
| Author | JoyPixels |
| Maintainers | joypixels |
| Keywords | joypixels, JoyPixels, emoji-toolkit, emojione, EmojiOne, emoji, emojis, emoticons, smileys, smilies, unicode, emoji set |

## Links

- npm: https://www.npmjs.com/package/emoji-toolkit
- Repository: https://github.com/joypixels/emoji-toolkit
- Homepage: https://www.joypixels.com
- Issues: https://github.com/joypixels/emoji-toolkit/issues
- npm.io page: https://npm.io/package/emoji-toolkit

## 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
- [stockfish](https://npm.io/package/stockfish.md) — 27.0K weekly downloads
- [@procore/core-icons](https://npm.io/package/@procore/core-icons.md) — 4.6K weekly downloads

## Recent versions

- 11.0.0 (latest) — 2026-08-03
- 10.0.0 — 2025-12-05
- 9.0.1 — 2024-07-21
- 9.0.0 — 2024-07-16
- 8.0.0 — 2023-08-22
- 7.0.1 — 2023-02-23
- 7.0.0 — 2022-10-12
- 6.6.0 — 2021-07-08
- 6.5.1 — 2021-02-23
- 6.0.1 — 2020-08-11
- 6.0.0 — 2020-07-14
- 5.5.1 — 2020-05-06
- 5.5.0 — 2020-02-12
- 5.0.5 — 2019-09-20
- 5.0.4 — 2019-08-26
- … 7 more at https://npm.io/package/emoji-toolkit/versions

## README

# ![JoyPixels Logo](https://cdn.joypixels.com/web-app/assets/joypixels-logo-color.png)

> [![npm version](https://img.shields.io/npm/v/emoji-toolkit.svg)](https://www.npmjs.com/package/emoji-toolkit) [![npm downloads](https://img.shields.io/npm/dt/emoji-toolkit.svg)](https://www.npmjs.com/package/emoji-toolkit) [![jsDelivr hits](https://data.jsdelivr.com/v1/package/npm/emoji-toolkit/badge?style=rounded)](https://www.jsdelivr.com/package/npm/emoji-toolkit)

A set of libraries to help users find and replace native system emojis with JoyPixels (formerly EmojiOne) in their app or website.

> Heads up! 
> EmojiOne has rebranded to JoyPixels. Please see our [UPGRADE DOC](UPGRADE.md) for details on what's new, especially 
> if you're migrating from [emojione](https://www.github.com/joypixels/emojione), as all references to "emojione" in
> class names and file names have been changed.

## What's Included?

 - This project includes libraries used to convert emoji into various formats, including conversion to JoyPixels emoji images.
 - All libraries included here are available free under the MIT license.
 
By default this toolkit utilizes individual emoji images to achieve a consistent appearance. JoyPixels also offers alternative approaches that may be better suited for your application, including [web & app fonts](https://app.joypixels.com/files/fonts) which can speed up and simplify your implementation.

## License to Use JoyPixels Images
 
### Version 3 and Above
Usage of JoyPixels artwork is bound by terms and conditions that vary depending upon your use case. Personal use typcically falls under a [Free License](https://app.joypixels.com/terms/free), whereas commercial use requires a [Paid License](https://joypixels.com/pricing).

### Version 2
JoyPixels version 2 is no longer supported or distributed. Please see [UPGRADE.md](UPGRADE.md) for instructions on upgrading from version 2 to the latest version. Version 2 was bound by the [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0/).

## Installation
To install the JoyPixels/emoji-toolkit, please refer to the guide at [INSTALLATION.md](INSTALLATION.md).


## Contributing
Please see [CONTRIBUTING.md](CONTRIBUTING.md) for more info on contributing to the JoyPixels/emoji-toolkit project. For artwork comments and questions please see the emojione-assets repo.

## Usage
You'll find basic usage examples here in the [/examples/](examples/) directory, and links to usage demos in [USAGE.md](USAGE.md).

## Change Log
See the [releases page](https://github.com/joypixels/emoji-toolkit/releases) for information on what's new in the latest release.

## Information

### Bug reports

If you discover any bugs, feel free to create an issue on GitHub. We also welcome the open-source community to contribute to the project by forking it and issuing pull requests.

 *  https://github.com/joypixels/emoji-toolkit/issues


### Contact

If you have any questions, comments, or concerns you are welcome to contact us.

*  [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/emojione/emojione?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
* [support@joypixels.com](mailto:support@joypixels.com)
* https://www.joypixels.com
* https://twitter.com/joypixels


### Alternatives
We sincerely hope that you choose to use JoyPixels and support our project, but if you feel like it's not for you, please have a look at these possible alternatives:

* https://github.com/emojidex/ (used to be known as [Phantom Open Emoji](https://github.com/Genshin/PhantomOpenEmoji))
* https://github.com/iamcal/emoji-data (with [PHP](https://github.com/iamcal/php-emoji) and [Javascript](https://github.com/iamcal/js-emoji) interfaces)
* https://github.com/node-modules/emoji
* https://github.com/steveklabnik/emoji
* https://github.com/muan/emojilib

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