Skip to content

Latest commit

 

History

270 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GameHub

Real-time multiplayer gaming platform for everyone

GameHub Banner

Star History

Star History Chart


Overview

GameHub is a real-time multiplayer browser gaming platform featuring a modern Glassmorphism design, optimized for both desktop and mobile.

Highlights

  • 15+ Games: Chess, UNO, Werewolf, Ludo, Maze, Billiard, and more
  • Smart Bots: AI integration (Stockfish, Minimax) for solo play
  • Real-time Sync: Instant synchronization via Socket.IO with lightweight Patch Compaction
  • Flexible Rooms: Public or password-protected private rooms
  • Live Chat: Global chat and in-room messaging

Project Structure

Directory Description
client/ React frontend with game UI and host-authoritative logic
server/ Relay server for data coordination
client/src/games/ Game architecture and how to create new games

Quick Start

Requirements: Node.js v18+ or Bun

# 1. Clone & Install
git clone https://github.com/HoangTran0410/gamehub24.git
cd gamehub
bun install  # or run npm install in client/ and server/ separately

# 2. Start Server (Terminal 1)
cd server && bun run dev

# 3. Start Client (Terminal 2)
cd client && bun run dev

Open your browser at: http://localhost:5173


Tech Stack

  • Frontend: React 19, TypeScript, Zustand, Tailwind CSS 4
  • Backend: Node.js, Express, Socket.IO
  • AI: Stockfish.js, Minimax Algorithm
  • UI/UX: Lucide Icons, Modern Glassmorphism Design

Contributing

Contributions are welcome!

  1. Fork the repository
  2. Create a new branch (feature/AmazingFeature)
  3. Commit and push your changes
  4. Open a Pull Request

License

Distributed under the MIT License.

Built with care by Hoang Tran

About

Viet Nam traditional games - play online with friends

Resources

Stars

38 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages