Emojinary is a high-performance, AI-driven puzzle game that challenges players to decode hidden words from a sequence of emojis. Built with TypeScript and React, it leverages the Groq AI model to dynamically generate unique puzzles across varying difficulty levels. The project features a refined neubrutalist UI, custom sound effects, and persistent progress tracking, providing an immersive experience for word-game enthusiasts.
A Node.js backend hosted via Vercel Serverless Functions that interfaces with the Groq AI model to generate contextually relevant word puzzles.
- LangChain / Groq AI: Dynamic puzzle and hint generation
- Zod: Strict schema validation for AI responses
- Vercel Functions: Serverless API deployment
- Custom Logic: Flavor-based thematic randomization
- Clone the repository:
git clone git@github.com:Charmingdc/Emojinary.git
- Install dependencies:
npm install
- Run the development server:
npm run dev
Create a .env file in the root directory and include:
GROQ_API_KEY=your_groq_api_key_here/api
Request: Query Parameters:
count(required): Number of puzzles to generate (e.g., 8)difficulty(required): Skill level. Options:easy,medium,hard,random
Response:
{
"success": true,
"data": [
{
"emojis": ["⛴️", "🌊", "🏙️"],
"letters": ["h", "a", "r", "b", "o", "r", "s", "x", "p"],
"answer": "harbor",
"hint": "A safe haven for vessels.",
"difficulty": "easy"
}
],
"difficulty": "easy"
}Errors:
- 405: Method Not Allowed
- 500: Failed to generate puzzles (AI provider or parsing error)
- Classic Mode: A continuous gauntlet of puzzles where players aim for the highest score based on speed and accuracy.
- Daily Challenge: A synchronized puzzle shared by all users worldwide, resetting every 24 hours.
- Difficulty Scaling: Intelligent point calculation that rewards players for harder challenges and penalizes for using hints.
- Interactive UI: A neumorphic design system with smooth animations powered by Framer Motion.
- Audio System: Context-aware sound effects for correct guesses, errors, and interface interactions.
- Progress Tracking: Local storage integration to save high scores and track daily completion status.
| Technology | Purpose |
|---|---|
| React 19 | Frontend library for building the user interface |
| TypeScript | Type-safe development across the stack |
| Tailwind CSS | Utility-first styling and neumorphic design |
| TanStack Query | Asynchronous state management and API caching |
| Groq AI | Large Language Model (LLM) for puzzle generation |
| Framer Motion | Advanced UI animations and transitions |
| Lucide / Phosphor | Iconography system |
| Vite | Frontend build tool and development server |
- Choose a Mode: Select "Classic" for a quick session or "Daily" for the global challenge.
- Decode Emojis: Analyze the emoji sequence displayed in the center of the screen.
- Select Letters: Tap the letters from the pool to fill the answer slots.
- Use Hints: If stuck, use the lightbulb icon, but be aware this reduces your potential score for that round.
- Share: Upon completion, use the share feature to copy your stats and challenge friends.
Contributions are what make the open-source community an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project.
- Create your Feature Branch (
git checkout -b feature/AmazingFeature). - Commit your Changes (
git commit -m 'Add some AmazingFeature'). - Push to the Branch (
git push origin feature/AmazingFeature). - Open a Pull Request.
- Adebayo Muis
- Twitter: @Charmingdc01
- GitHub: Charmingdc
