Can you crack the code before time runs out? SuperGuess is a modern, full-stack web application that reinvents the classic "Guess the Number" game with arcade mechanics, dynamic visuals, and high-stakes gameplay.
- 4 Distinct Difficulty Levels:
- Rookie (1-50): Standard gameplay.
- Agent (1-200): Expanded range.
- Grandmaster (1-1000): The ultimate test of logic.
⚠️ CHAOS MODE: A time-attack frenzy. 30 seconds on the clock. Every win adds +10s. How high can your streak go?
- ♾️ Unlimited Practice Mode: Toggle "Unlimited Lives" to practice without the pressure of a Game Over.
- 🧠 Intelligent Hint System: Spend points to analyze the target (Prime checks, Divisibility rules, Digit sums).
- Dynamic Proximity Bar: A visual "Hot/Cold" meter that fills up based on absolute distance to the target.
- Dual Theme System:
- 🕹️ Arcade Mode: Neon, glowing text, retro-futuristic vibes (Default).
- 🔮 Stealth Mode: Matte black, high-contrast green/white, minimalist interface.
- Responsive Design: Fully optimized for Mobile, Tablet, and Desktop.
- Juice & Polish: Screen shake on errors, confetti on wins, CRT flicker effects, and immersive sound effects (with Mute toggle).
The game features a sophisticated feedback engine that guides players using color-coded tiers:
| Distance | Status | Color Indicator |
|---|---|---|
| 0 | TARGET ACQUIRED | 🟢 Green |
| < 3 | BURNING HOT | 🔴 Bright Red |
| < 10 | HOT | 🔴 Soft Red |
| < 25 | WARM | 🟠 Orange |
| < 50 | COOL | 🟡 Gold |
| < 100 | COLD | 🔵 Blue |
| > 100 | FREEZING | 🟣 Purple |
- Backend: Python (Flask), Gunicorn
- Frontend: HTML5, CSS3 (Variables & Animations), JavaScript (Fetch API)
- Architecture:
- Server-Side Sessions: Securely stores game state (secret number, history) in signed cookies.
- Decoupled Engine: Game logic (
engine/game.py) is separate from web routes (routes.py) for modularity. - RESTful Design: The game communicates via JSON API endpoints for seamless, non-reloading gameplay.
| Arcade Theme | Stealth Theme |
|---|---|
 |
 |
| Mobile View | Chaos Mode |
|---|---|
 |
 |
Want to run this on your own machine?
-
Clone the repository
git clone https://github.com/CaSh007s/superguess.git cd superguess -
Create a Virtual Environment
python -m venv venv # Windows: venv\Scripts\activate # Mac/Linux: source venv/bin/activate
-
Install Dependencies
pip install -r requirements.txt
-
Run the App
python run.py
Visit
http://127.0.0.1:5000in your browser.
Got an idea for Level 5? Pull requests are welcome!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
[Kalash Pratap Gaur]
- GitHub: @CaSh007s
Built with 💻 and ☕ by [Kalash].