🇺🇸 U.S. Presidents Quiz

A fun and educational browser game to test your knowledge of American presidents!

Can you identify the U.S. presidents from their portraits before time runs out?

✨ Features

• 🇺🇸 Guess presidents by photo or clues (years of service)
• 🧠 Tracks your score - best score & time enters you to the Hall of Fame
• 🕹️ Playable in-browser – no downloads
• 📱 Fully responsive design (still beter gameplay on destop, though)
• 🧾 Educational focus - play it a few times and you will learn them all. No kidding!

If you enjoy the game or find it useful, please consider giving the repo a ⭐️ — it really helps!

🚀 Tech Stack

• Framework: Next.js
• Language: TypeScript
• Styling: Tailwind CSS
• Fonts: Google Fonts (Lora & Pirata One)

☝️ IMPORTANT!

This project was developed as an experiment for vibe-coding with GEMINI-CLI

I will describe my conclusions on this on a separate article or blog post and put a link here when it's published.

🛠️ Getting Started

To run this project locally, follow these simple steps:

1. Clone the repository:

   git clone https://github.com/plamen5rov/presidents-quiz-gemini-cli
   cd your-repo-name

2. Install dependencies:

   npm install

3. Run the development server:

   npm run dev

4. Open http://localhost:3000 in your browser to start playing!

🎮 Live Demo

👉 Play the Game Here

🎮 Demo

👨‍💻 Author: Plamen Petrov – @plamen5rov

📄 License

This project is licensed under the MIT License

⚠️ Disclaimer

This game is for educational and informational purposes only. It is not affiliated with or endorsed by any government agency or public office.

⭐ Like this project?

If you enjoyed playing this game or found the code helpful, please consider giving this repository a star! It's a great way to show your support. Thank you!

📈 Star History