A web-based hangman-style guessing game where players guess letters to uncover a hidden word. Designed as a fun interactive game using Python, Flask, and JavaScript for the web.
Play it live: https://otis-hangman.herokuapp.com/
This project is a hangman-style guessing game built with Python (Flask) for the backend and HTML/CSS/JavaScript for the frontend. Players choose from categories and try to guess a hidden word one letter at a time until they succeed or run out of attempts.
The goal is to create a responsive and enjoyable web game that showcases full-stack web development fundamentals. :contentReference[oaicite:1]{index=1}
✔ Choose a random word from category lists
✔ Letter input and real-time reveal of correct guesses
✔ Tracks wrong guesses and attempts remaining
✔ Option to replay after game over
✔ Deployed and accessible online
This project was built with:
- Python (Flask) for the server
- HTML, CSS, JavaScript for the frontend
- GitHub for source control
- Heroku for live deployment
- Gitpod for cloud-based development environment
To run this on your local machine:
- Clone the repo
git clone https://github.com/passportpowell/hangman-guessing-game.git cd hangman-country-guessing-game
Create and activate a virtual environment
python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate
Install dependencies
pip install -r requirements.txt
Start the server
python run.py
Visit http://localhost:5000 in your browser.
🎮 How to Play
Open the app in your browser.
Select a category of words.
Guess letters by typing them in.
Correct letters will be revealed; incorrect ones will count toward your attempt limit.
Win by guessing all letters before attempts run out!
📌 Known Issues
Word list could be expanded for more variety.
No persistent high-score tracking yet.
UI improvements and mobile layout polishing needed.
💡 Future Improvements
🎮 Multiplayer mode
⭐ Top 10 score board
📂 Expand category selection
🎨 New visual themes
🧪 Testing
This project does not have automated tests yet, but you can manually interact with every feature (selecting letters, replaying game, handling edge inputs) via the live or local version.
📚 Credits
Built by Passport Powell as part of the Portfolio Assessment 3 project.
Thanks to:
StackOverflow for Python help links
Python docs for language reference
📄 License
This project is licensed under the MIT License. See the full text in LICENSE. Feel free to use, adapt, and extend the game for your own purposes.