1 files changed, 28 insertions, 0 deletions

diff --git a/README.md b/README.md
index 6ba456f..d858eb4 100644
--- a/README.md
+++ b/README.md
@@ -610,6 +610,34 @@ test "Scripts" {
 }
 ```
 
+## Emoji
+
+To get information about emoji and emoji-like characters, use the `Emoji` module.
+
+In your `build.zig`:
+
+```zig
+exe.root_module.addImport("Emoji", zg.module("Emoji"));
+```
+
+In your code:
+
+```zig
+const Emoji = @import("Emoji");
+
+test "Emoji" {
+    const emoji = try Emoji.init(allocator);
+    defer emoji.deinit(allocator);
+
+    try expect(emoji.isEmoji(0x1F415)); // 🐕
+    try expect(emoji.isEmojiPresentation(0x1F408)); // 🐈
+    try expect(emoji.isEmojiModifier(0x1F3FF)); // 🏿
+    try expect(emoji.isEmojiModifierBase(0x1F977)); // 🥷
+    try expect(emoji.isEmojiComponent(0x1F9B0)); // 🦰
+    try expect(emoji.isExtendedPictographic(0x1F005)); // 🀅
+}
+```
+
 ## Limits
 
 Iterators, and fragment types such as `CodePoint`, `Grapheme` and