Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

emojione

emojione92.5k4.5.0TypeScript support: definitely-typed

EmojiOne is a complete set of emojis designed for the web. It includes libraries to easily convert unicode characters to shortnames (:smile:) and shortnames to our custom emoji images. PNG formats provided for the emoji images.

emojione, EmojiOne, emoji, emojis, emoticons, smileys, smilies, unicode, emoji set

readme

EmojiOne Logo

npm version npm downloads jsDelivr hits

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

What's Included?

  • This project includes libraries used to convert emoji into various formats, including conversion to EmojiOne emoji images.
  • All libraries included here are available free under the MIT license.

License to Use EmojiOne Images

EmojiOne Version 4

EmojiOne Version 4 is available under the same licensing structure as Version 3. Please see below for more details.

EmojiOne Version 3+

EmojiOne launched version 3.0 in 2017, which has several licensing options available. PNG 32px, 64px, and 128px as well as 32px and 64px sprites are available for digital use, with attribution. See https://www.emojione.com/licenses/free for more information on usage and attribution requirements.

Premium Licenses are available for larger PNG assets and SVG assets, for digital and print use (within budget constraints). See https://www.emojione.com/licenses/premium for more information or to obtain a Premium License.

For product/retail licensing, visit https://www.joypixels.com.

EmojiOne Version 2

EmojiOne version 2 is no longer supported or distributed. Please see UPGRADE.md for instructions on upgrading from version 2 to version 3. Version 2 was bound by the Creative Commons Attribution 4.0 International License.

Installation

To install emojione, please refer to the guide at INSTALLATION.md. Version 3 introduces many potentially-breaking changes. Refer to the UPGRADE.md documentation for more details.

Contributing

Please see CONTRIBUTING.md for more info on contributing to the emojione project. For artwork comments and questions please see the emojione-assets repo.

Usage

You'll find basic usage examples here in the /examples/ directory, and links to usage demos in USAGE.md.

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.

Contact

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

Alternatives

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

changelog

changelog

UPDATE 2017-06-30

  • additions

    • Unicode 10 charcters
  • changes

    • inclusion of output code point attribute, used to generate native Unicode

UPDATE 2017-04-15

  • additions

    • gender based roles
    • aliases for diversity naming convention (e.g. tone1 = light_skin_tone)
  • changes

    • in a previous version, csv columns were renamed to more closely match the json attribute labels. now we've updated "alpha code" to "alpha_code" for closer alignment
    • we've removed the versioning from this data set now that it's part of the emojione repo

1.1 / 2016-07-19

  • additions

    • all of unicode 9
    • :gay_pride_flag:
  • important note

    • because aliases are pipe-delimited strings, we have removed square bracket encapsulation and replaced with double-quote encapsulation

0.9 / 2016-04-05

  • additions
    • :paw_prints: alias to paw prints
    • :thumbup: alias to thumbs up sign
    • :thumbup_tone1: alias to thumbs up sign tone 1
    • :thumbup_tone2: alias to thumbs up sign tone 2
    • :thumbup_tone3: alias to thumbs up sign tone 3
    • :thumbup_tone4: alias to thumbs up sign tone 4
    • :thumbup_tone5: alias to thumbs up sign tone 5
    • :thumbdown: alias to thumbs down sign
    • :thumbdown_tone1: alias to thumbs down sign tone 1
    • :thumbdown_tone2: alias to thumbs down sign tone 2
    • :thumbdown_tone3: alias to thumbs down sign tone 3
    • :thumbdown_tone4: alias to thumbs down sign tone 4
    • :thumbdown_tone5: alias to thumbs down sign tone 5

0.8 / 2015-12-17

  • Initial commit