emoji_utils 0.0.1

A lightweight Dart utility for accurate single emoji detection. Handles ZWJ sequences, skin tone modifiers, variation selectors, flags, and all modern Unicode emoji ranges.

Emoji Utils

A lightweight, pure Dart utility for detecting whether a string contains a single emoji. Correctly handles the full complexity of Unicode emoji sequences.

Features

• ZWJ Sequences — Family (👨‍👩‍👧‍👦), profession, and combined emojis.
• Skin Tone Modifiers — Fitzpatrick scale support (👋🏽).
• Variation Selectors — Handles both text and emoji presentation (❤️ vs ❤).
• Flag Sequences — Regional indicator pairs (🇹🇷, 🇺🇸).
• Full Unicode 15.1 — All modern emoji ranges covered.
• Zero Dependencies — Pure Dart, no Flutter required.

Installation

dependencies:
  emoji_utils: ^<latest_version>

Usage

import 'package:emoji_utils/emoji_utils.dart';

// Basic emojis
EmojiUtils.isSingleEmoji('😀');      // true
EmojiUtils.isSingleEmoji('🎉');      // true

// Compound emojis
EmojiUtils.isSingleEmoji('👨‍👩‍👧‍👦'); // true (ZWJ family)
EmojiUtils.isSingleEmoji('👋🏽');     // true (skin tone)
EmojiUtils.isSingleEmoji('🇹🇷');     // true (flag)
EmojiUtils.isSingleEmoji('❤️');      // true (variation selector)

// Non-emoji strings
EmojiUtils.isSingleEmoji('Hello');   // false
EmojiUtils.isSingleEmoji('😀😀');    // false (two emojis)
EmojiUtils.isSingleEmoji('');        // false
EmojiUtils.isSingleEmoji('abc😀');   // false (mixed)

Common Use Case: Chat Bubbles

Display single emojis larger in chat messages, like iMessage or WhatsApp:

final message = '❤️';

if (EmojiUtils.isSingleEmoji(message)) {
  // Render as a large standalone emoji (no bubble)
  return Text(message, style: TextStyle(fontSize: 64));
} else {
  // Render inside a normal chat bubble
  return ChatBubble(child: Text(message));
}

License

Licensed under the MIT License.