🧠 Mind Palace Game

Mind Palace is an immersive quiz adventure designed to make learning fun, challenging, and memorable. You journey through 20 unique "rooms," each containing a puzzle or question from subjects like math, science, history, and more — and unlock new chambers by solving them!

---

🌐 Live Preview

🎮 Play Mind Palace

---

✨ Features

• 🧩 20 Knowledge Rooms with subject-diverse questions
• 👾 Floating Animated Character for immersive game feel
• 🎉 Confetti Celebration when the final room is unlocked
• 📱 Responsive Design optimized for desktop & mobile
• 🔐 Keyboard Shortcuts (Enter to submit answers)
• 🌈 Modern UI with gradients, shadowed cards, and smooth UX
• 🎨 Tailwind CSS styling with custom illustrations
• 🧠 Perfect for students, quiz lovers, and brain game fans

---

🛠 Tech Stack

• Framework: React (Next.js)
• Styling: Tailwind CSS
• Animation: Canvas Confetti, Framer Motion (optional)
• Illustrations: Custom character image, gradients, and icons
• Hosting: Vercel

---

📁 Folder Structure

mind-palace-game/
├── public/
│   ├── background-texture.svg
│   ├── character.png
│   └── screenshot.png
├── src/
│   ├── components/
│   │   └── MindPalaceGame.tsx
│   └── app/
│       └── page.tsx
├── README.md
├── discussion.md
├── package.json
└── tailwind.config.ts

---

🚀 Getting Started Locally

1. Clone the repository:

   git clone https://github.com/nitinyadav2188/MindPalace.git
   cd mind-palace-game

2. Install dependencies:

   npm install

3. Run the development server:

   npm run dev

4. Visit http://localhost:5173 in your browser.

---

💡 Project Purpose

• Help high school students learn faster and retain knowledge in a gamified way.
• Provide teachers and ed-tech mentors a tool to engage students with subject-wise challenges.
• Showcase how agentic AI and game design can boost motivation.

---

🎯 Future Enhancements

• 🌍 Multi-language support
• 🔊 Sound & background music
• 🧙‍♂️ Animated story cutscenes
• 💾 Save progress with user login
• 🏆 Leaderboard & challenge system

---

🙌 Contributing

1. Fork the repository
2. Create your feature branch:

   git checkout -b feature/amazing-feature

3. Commit your changes
4. Push to the branch
5. Open a Pull Request

---

📄 License

MIT License.
Free to use for learning, fun, and open-source contributions.

---

✨ Credits

• Confetti Animation: canvas-confetti
• UI Inspiration: Vercel, TailwindUI, Framer Motion demos
• Character Illustration: Custom drawing (or mention attribution)
• Fonts & Icons: [Google Fonts], [Lucide Icons], [HeroIcons]

---

"Unlock your genius — one puzzle at a time."
— Mind Palace Dev Team