EmojiRiddle 🧠

A fun emoji-based math puzzle game. Solve equations where emojis represent numbers!

Quick Start

# Clone and run
git clone <repository-url>
cd emojiriddle
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn main:app --reload

Open http://localhost:8009 and start playing! 🎮

How to Play

1. See emoji equations (e.g., 🐶 + 🐶 = 8)
2. Figure out what number each emoji represents
3. Enter your answers and submit
4. Get instant feedback and a new puzzle!

Tech Stack

• Backend: FastAPI (Python)
• Frontend: Vanilla HTML/CSS/JavaScript
• No frameworks required - Just run and play!

Documentation

For detailed information, see the docs/README.md.

---

Ready to push to GitHub! 🚀