Skip to content

passportpowell/geo-quiz-engine

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🧠 Capital Cities Quiz

GitHub Pages License: MIT Languages

A fun interactive quiz game to test your knowledge of capital cities. Built with HTML, CSS, and JavaScript.


🚀 Live Demo

Play the quiz online:
https://passportpowell.github.io/capital-cities-quiz/


📌 Overview

This project is a browser-based quiz game that challenges users to identify capital cities from a list of choices. The quiz presents questions one at a time, provides immediate feedback, and shows the final score at the end, demonstrating dynamic front-end behavior using standard web technologies. :contentReference[oaicite:2]{index=2}


🧠 Features

✔ Multiple choice questions
✔ Interactive scoring
✔ Responsive layout for different screen sizes
✔ Easy to extend with more questions
✔ Deployable on GitHub Pages


📸 Screenshots

Main Quiz Screen Answer Feedback


🛠️ Tech Stack

This project was built with:

  • HTML5
  • CSS3
  • JavaScript (Vanilla)
  • GitHub Pages (optional live hosting)

⚙️ Installation (Local)

To run this locally:

git clone https://github.com/passportpowell/capital-cities-quiz.git
cd capital-cities-quiz


Open the project in a browser or serve it with a simple web server:

python3 -m http.server 8000


Then visit http://localhost:8000 in your browser.

📋 How to Play

Click “Start Quiz” to begin.

Read the question and choose the correct capital.

Get immediate feedback for each answer.

Finish all questions to see your final score.

Restart any time to play again.

📌 Known Issues

Could use more diverse question sets.

No persistent high score tracking yet.

Accessibility improvements can be added.

💡 Future Improvements

Add sound effects and animations

Store high scores in Local Storage

Add difficulty levels

🧪 Testing

Manual testing steps:

✔ Load in multiple browsers
✔ Confirm correct scoring
✔ Check layout on mobile and desktop

📚 Credits

Developed by Passport Powell as a browser quiz project.

📄 License

This project is released under the MIT License. Feel free to use, modify, or share it.

About

Interactive geography assessment tool built with vanilla JavaScript, focusing on DOM manipulation and state management.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors