A lightweight TypeScript library for generating random Unicode emojis. Features embedded Unicode data for instant offline usage with 3,781+ emojis across 100 categories.

• 🚀 Instant startup - No network requests, embedded data
• 📦 Offline ready - Works without internet connection
• 🎲 3,781+ emojis - Latest Unicode emoji data
• 📂 98 categories - Organized by emoji type
• ⚡ Lightweight - Minified browser bundle (~176KB, 26KB gzipped)
• 🔧 TypeScript - Full type safety and IntelliSense
• 🌐 Universal - Works in Node.js, browser, and standalone
• 🎯 Zero dependencies - No external files or network requests

npm install @neabyte/unicode-gen

<!-- Via CDN -->
<script src="https://unpkg.com/@neabyte/unicode-gen@latest/dist/unicode-gen.min.js"></script>

<!-- Or download and include locally -->
<script src="path/to/unicode-gen.min.js"></script>

<!-- ES Modules -->
<script type="module">
  import generator from 'https://unpkg.com/@neabyte/unicode-gen@latest/dist/unicode-gen.esm.js'
</script>

import generator from '@neabyte/unicode-gen'

// Get random emoji
generator.random() // '😀'

// Access the global UnicodeGen object
const generator = UnicodeGen.default

// Get random emoji
generator.random() // '😀'

import generator from '@neabyte/unicode-gen'

// Get random emoji (default)
generator.random() // '😀'

// Get random emoji code
generator.random({ type: 'code' }) // '1F600'

// Get multiple random emojis
generator.random({ count: 5 }) // ['😀', '😃', '😄', '😁', '😆']

// Get from specific category
generator.random({ category: 'face-smiling' }) // '😀'

// Get full emoji object
generator.random({ type: 'both' }) // { code: '1F600', emoji: '😀' }

Generate random emojis with flexible options.

Options:

• count?: number - Number of emojis to return (default: 1)
• category?: string - Specific category to choose from
• type?: 'code' | 'emoji' | 'both' - Return format (default: 'emoji')

Type Examples:

• type: 'emoji' - Returns emoji characters (default)
• type: 'code' - Returns Unicode codes
• type: 'both' - Returns full objects with code and emoji

Returns:

• Single emoji: string or EmojiData
• Multiple emojis: string[] or EmojiData[]

Returns array of available category names.

Returns all emojis in the specified category.

// Create your own instance
import { UnicodeGenerator } from '@neabyte/unicode-gen'

const generator = new UnicodeGenerator()
await generator.loadData()

// Use like normal
generator.random() // '😀'

// Get all available categories
const categories = generator.getCategories()
console.log(categories) // ['face-smiling', 'heart', 'animal-mammal', ...]

// Get all emojis from a category
const hearts = generator.getEmojisByCategory('heart')
console.log(hearts.length) // 25
console.log(hearts.map(e => e.emoji).join(' ')) // '💌 💘 💝 💖 💗 ...'

// Validate category exists
const categories = generator.getCategories()
if (categories.includes('face-smiling')) {
  const emoji = generator.random({ category: 'face-smiling' })
}

// Handle invalid options
try {
  generator.random({ count: 0 }) // Throws error
} catch (error) {
  console.log('Invalid count:', error.message)
}

Your library includes 98 emoji categories:

• face-smiling, face-affection, face-tongue, face-hand
• face-neutral-skeptical, face-sleepy, face-unwell
• face-hat, face-glasses, face-concerned, face-negative
• face-costume, cat-face, monkey-face, heart, emotion

• animal-mammal, animal-bird, animal-amphibian
• animal-reptile, animal-marine, animal-bug
• plant-flower, plant-other

• food-fruit, food-vegetable, food-prepared
• food-asian, food-sweet, drink, dishware

• place-map, place-geographic, place-building
• place-religious, place-other
• transport-ground, transport-water, transport-air

• person, person-gesture, person-role, person-fantasy
• person-activity, person-sport, person-resting
• family, person-symbol

• clothing, sound, music, musical-instrument
• phone, computer, light-video, book-paper
• money, mail, writing, office, lock, tool
• science, medical, household, other-object

• transport-sign, warning, arrow, religion, zodiac
• av-symbol, gender, math, punctuation, currency
• other-symbol, keycap, alphanum, geometric

• flag, country-flag, subdivision-flag

For complete API reference and examples, see the full documentation.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

MIT © NeaByteLab