# emoji.today - Complete Documentation

> The daily emoji voting platform where the world decides which emoji defines the day.

## Site Overview

emoji.today is a comprehensive emoji reference combined with a unique social voting mechanic. Each day, users around the world vote for the single emoji that best represents that day. The winning emoji becomes part of a permanent historical record.

### Core Value Proposition
1. **Emoji Reference**: Complete database of 1881+ emojis with meanings, usage examples, and technical details
2. **Daily Voting**: Participatory ritual where communities decide the "emoji of the day"
3. **Historical Record**: Permanent archive of winning emojis, creating a symbolic timeline of human events

## Content Structure

### Emoji Detail Pages

Each emoji has a dedicated page at `/emojis/[slug]` with:

- **Description**: AI-generated 2-3 sentence explanation of meaning and usage
- **Alt Names**: Common nicknames for the emoji (e.g., "Crying Laughing" for 😂)
- **Keywords**: Searchable terms associated with the emoji
- **Use Cases**: Specific scenarios where the emoji is commonly used
- **Vibe**: 1-3 word essence of the emoji's energy
- **Fun Fact**: Historical or cultural trivia when available
- **Sentiment**: Positive/negative/neutral/mixed classification
- **Tone Tags**: Usage tones (sarcastic, sincere, playful, etc.)
- **Common Combos**: Frequently paired emoji combinations
- **Similar Emojis**: Related emojis for the same concepts
- **Platform Previews**: Visual comparison across Apple, Google, Twitter, Facebook
- **Unicode Data**: Codepoint, version, qualification status

### Category Structure

#### 😀 Smileys & Emotion
- URL: /emojis/category/smileys-emotion
- Description: Express every feeling with smiley faces, hearts, and emotional symbols. From joy to tears, find the perfect emoji to match your mood.
- Keywords: smiley, face, emotion, happy, sad, love, heart, feeling, mood, expression

#### 👋 People & Body
- URL: /emojis/category/people-body
- Description: People, gestures, and body parts. Represent yourself, your family, and communicate with hand gestures, from thumbs up to waving hello.
- Keywords: people, person, hand, gesture, body, family, profession, wave, thumbs up, pointing

#### 🐶 Animals & Nature
- URL: /emojis/category/animals-nature
- Description: The animal kingdom and natural world in emoji form. Dogs, cats, flowers, weather, and everything from the great outdoors.
- Keywords: animal, nature, pet, dog, cat, flower, plant, weather, wildlife, outdoors

#### 🍕 Food & Drink
- URL: /emojis/category/food-drink
- Description: Delicious food and refreshing drinks. From pizza to sushi, coffee to cocktails—every cuisine and beverage you can imagine.
- Keywords: food, drink, eat, meal, fruit, vegetable, dessert, coffee, pizza, restaurant

#### ✈️ Travel & Places
- URL: /emojis/category/travel-places
- Description: Explore the world with travel and places emojis. Landmarks, vehicles, buildings, and everything you need for your next adventure.
- Keywords: travel, place, building, vehicle, transport, city, landmark, vacation, airplane, car

#### ⚽ Activities
- URL: /emojis/category/activities
- Description: Sports, hobbies, and recreational activities. From soccer to video games, music to art—show off what you love to do.
- Keywords: activity, sport, game, hobby, music, art, ball, trophy, medal, recreation

#### 💡 Objects
- URL: /emojis/category/objects
- Description: Everyday objects and tools. Technology, office supplies, household items, and all the things that make life work.
- Keywords: object, tool, technology, phone, computer, office, home, light, clock, key

#### ❤️ Symbols
- URL: /emojis/category/symbols
- Description: Universal symbols, signs, and shapes. Hearts, arrows, zodiac signs, and all the icons that communicate without words.
- Keywords: symbol, sign, heart, arrow, zodiac, shape, number, letter, warning, icon

#### 🏳️ Flags
- URL: /emojis/category/flags
- Description: Flags from around the world. Represent your country, show national pride, or mark international events with country flags.
- Keywords: flag, country, nation, world, international, pride, banner, national

## Example Emoji Data

### 😀 GRINNING FACE
- Page: /emojis/grinning-face
- Category: Smileys & Emotion

### 😃 GRINNING FACE WITH BIG EYES
- Page: /emojis/grinning-face-with-big-eyes
- Category: Smileys & Emotion

### 😄 GRINNING FACE WITH SMILING EYES
- Page: /emojis/grinning-face-with-smiling-eyes
- Category: Smileys & Emotion

### 😁 BEAMING FACE WITH SMILING EYES
- Page: /emojis/beaming-face-with-smiling-eyes
- Category: Smileys & Emotion

### 😆 GRINNING SQUINTING FACE
- Page: /emojis/grinning-squinting-face
- Category: Smileys & Emotion

### 😅 GRINNING FACE WITH SWEAT
- Page: /emojis/grinning-face-with-sweat
- Category: Smileys & Emotion

### 🤣 ROLLING ON THE FLOOR LAUGHING
- Page: /emojis/rolling-on-the-floor-laughing
- Category: Smileys & Emotion

### 😂 FACE WITH TEARS OF JOY
- Page: /emojis/face-with-tears-of-joy
- Category: Smileys & Emotion

### 🙂 SLIGHTLY SMILING FACE
- Page: /emojis/slightly-smiling-face
- Category: Smileys & Emotion

### 🙃 UPSIDE-DOWN FACE
- Page: /emojis/upside-down-face
- Category: Smileys & Emotion

## URL Patterns

- Homepage: /
- All Emojis: /emojis
- Category: /emojis/category/[category-slug]
- Emoji Detail: /emojis/[emoji-slug]
- Timeline: /story
- Leaderboard: /leaderboard
- Daily Results: /story/[YYYY-MM-DD]

## Data Sources

- Emoji data follows Unicode Emoji specifications
- Descriptions and metadata are AI-generated for contextual understanding
- Vote data is collected from authenticated Farcaster users
- Results are finalized at UTC midnight daily

## Machine-Readable Formats

- Sitemap: /sitemap.xml
- robots.txt: /robots.txt
- JSON-LD structured data on all pages

## Updates

- Emoji database updated with each Unicode release
- AI descriptions are continuously improved
- Vote data updates in real-time during active voting periods