Clone this repo:
  1. f117f7e Merge pull request #55 from googlefonts/e15 by Rod · 6 weeks ago main
  2. 034c7af Update 15.0 ordering by Rod S · 6 weeks ago
  3. 5e7a618 Merge pull request #53 from googlefonts/update_15_0 by Henrik Porseland · 3 months ago
  4. 690304a Update 15.0 metadata by Henrik Porseland · 3 months ago
  5. 9b3126a Merge pull request #52 from googlefonts/15_0_2023_03_08 by Henrik Porseland · 3 months ago

This repository provides metadata to support UX around emoji. In particular, it describes how to construct an emoji picker with full support for skin tones. The json files describe a grid layout for an emoji picker with 9 emoji per row:

  • emoji_13_0_ordering.json for Emoji 13.0.
  • emoji_13_1_ordering.json for Emoji 13.1.
  • emoji_14_0_ordering.json for Emoji 14.0.
  • emoji_15_0_ordering.json for Emoji 15.0.

As emoji evolves new orderings will be added.

A snippet is shown annotated below:

  {
  	// The is the people section
    "group": "People",
    "emoji": [
      {
      	// This is the codepoint sequence for the emoji that should show in the grid
      	// Generally the base is the most neutral version available, such as the
      	// genderless gold skintone version.
        "base": [
          128583
        ],
        // These are alternate versions, typically shown as a long-press flyout
        "alternates": [
          [
            128583
          ],
          [
            128583,
            127995
          ],
          // ...etc...
        ],
        // Emoticon(s)
        "emoticons": [
          ">:P"
        ],
        // Shortcode(s)
        "shortcodes": [
          ":smirk:"
        ],
      },

Here is what the people section could look like:

People

Here are the alternates for Santa, as might be shown on long-press for the base Santa:

People

The https://github.com/googlefonts/noto-emoji repository provides Google's Emoji.