Skip to content

samitochi04/Guess

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Guess

Flyer

🎮 Guess – The Ultimate Fast-Paced Multiplayer Guessing Game

Guess is a real-time multiplayer web app where players describe and guess famous people, places, or things under time pressure. Designed for quick gaming sessions between classes, Guess challenges your speed, wit, and descriptive skills. Create or join game sessions, compete with friends, and climb the leaderboard – all in just a few minutes!

✨ Features

  • Multiplayer Sessions: Play with 3 to 20 players in fast-paced guessing rounds.
  • Dynamic Gameplay: One player describes, the rest guess – fastest correct guess wins!
  • Real-time Action: Experience seamless, live gameplay powered by WebSockets.
  • Language Support: Play in either English or French – switch easily anytime.
  • User Profiles & Stats: Track your scores, see past sessions, and view your ranking.
  • Responsive Design: Enjoy a smooth experience on both desktop and mobile devices.

🛠️ Tech Stack

Frontend:

  • HTML5, Tailwind CSS, JavaScript
  • Responsive design for seamless mobile and desktop experiences

Backend:

  • Node.js, Express.js
  • WebSockets for real-time guessing
  • JWT (JSON Web Tokens) for secure authentication

Database:

  • MySQL for storing user data, game content, and session stats

Tools:

  • UI/UX: Adobe XD
  • Project Management: Notion
  • Version Control: Git & GitHub

🚀 How to Get Started

  1. Clone the Repository:
    git clone https://github.com/username/guess.git
  2. Install Dependencies:
    cd guess
    npm install
  3. Set Up Environment:
    • Create a .env file and configure database and WebSocket settings.
  4. Run the App:
    npm start
  5. Access the Game:
    Open http://localhost:3000 in your browser.

📜 Game Rules

  • A session hosts 3 to 20 players.
  • Each player takes turns describing a famous person, place, or thing.
  • 60-90 seconds for description, followed by 15 seconds for others to guess.
  • Fastest correct guesser leads the scoreboard.
  • The player with the highest points at the end wins.

🏗️ Roadmap

  • Upcoming Features:
    • New game modes
    • Additional languages
    • Advanced scoring system.

About

Guess

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors