Skip to content

🎲 A Flask-powered web game where players guess a random number with hints, scoring, and replay simple, responsive, and fun.

Notifications You must be signed in to change notification settings

markdennis2121/flask-random-game

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

8 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🧾 README.md Template markdown

🎲 Flask Random Number Guessing Game – by Mark Dennis

A responsive web-based guessing game built with Flask. Pick your difficulty, guess the secret number, get hot/cold hints, track your accuracy, and replay as many times as you like!


πŸš€ Features

  • Difficulty Modes: Easy (1–50), Medium (1–100), Hard (1–200)
  • Proximity Hints: β€œVery close!”, β€œToo high!”, β€œToo low!”
  • Accuracy Scoring: Score out of 100 based on guess precision
  • Guess History: See all your previous guesses
  • Replay & Reset: Start new games without restarting the server
  • Responsive UI: Modern CSS, centered card layout, speech-bubble feedback

πŸ›  Tech Stack

  • Python 3.x
  • Flask
  • Jinja2 templating
  • HTML5 & CSS3
  • Session management

▢️ How to Run

  1. Install dependencies:
    pip install flask

Run the app:

bash python app.py Open your browser:

http://127.0.0.1:5000 πŸ‘¨β€πŸ’» About Created by Mark Dennis πŸ”— GitHub Profile πŸ“ Bacolod, Philippines

πŸ“Œ Future Enhancements Add leaderboard or score tracking

Store game history in a database

Add sound effects or animations

Deploy to the web via Render or Vercel

🀝 Contributions Suggestions and forks are welcome! Feel free to star ⭐ or open an issue.

About

🎲 A Flask-powered web game where players guess a random number with hints, scoring, and replay simple, responsive, and fun.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published