Real-Time Multiplayer Chess

A modern, real-time multiplayer chess application built with SvelteKit, Socket.IO, and Redis. Play chess with friends through shareable game links, featuring real-time moves, game state management, and WebSocket communication.

🎮 Play Now - Live Demo

🚀 Features

• Real-time multiplayer gameplay
• Shareable game links with QR codes
• Game state persistence with Redis
• Secure WebSocket connections (WSS)
• Mobile-responsive design
• Time controls for each player
• Move validation and chess rules enforcement
• Production-grade SSL/TLS encryption

🛠 Tech Stack

• Frontend: SvelteKit, TypeScript
• Backend: Node.js, Express
• Real-time: Socket.IO
• State Management: Redis
• Security: Helmet, Rate Limiting, Let's Encrypt SSL
• Deployment: Docker, DigitalOcean

🏗 Architecture

+----------------+     WebSocket     +----------------+     Persist     +----------------+
|                | <--------------> |                | <------------> |                |
|  SvelteKit UI  |    Socket.IO     |  Express/Node  |     State      |     Redis      |
|                |                  |                |                |                |
+----------------+                  +----------------+                +----------------+

🔧 Setup & Development

1. Clone the repository:

   git clone https://github.com/yourusername/chess-app.git
   cd chess-app
   

2. Install dependencies:

   npm install
   

3. Set up environment variables:

   cp .env.example .env
   # Edit .env with your configuration
   

4. Start development server:

   npm run dev
   

5. For production build:

   npm run build
   npm run start
   

🐳 Docker Deployment

# Build and run with Docker Compose
docker compose up -d

📁 Project Structure

chess-app/
├── src/
│   ├── lib/           # Shared components and utilities
│   ├── routes/        # SvelteKit routes and pages
│   ├── server/        # Backend server code
│   └── server.ts      # Main server entry point
├── static/           # Static assets
├── certs/           # SSL certificates
└── docker-compose.yml

🔐 Security

• HTTPS/SSL encryption with Let's Encrypt
• Automatic SSL certificate renewal
• HTTP to HTTPS redirection
• Strict Transport Security (HSTS)
• Rate limiting
• Helmet security headers
• Secure WebSocket (WSS) connections
• Input validation
• Content Security Policy (CSP)

🌐 Deployment

The application is deployed at chess.bidseek.dev using:

• DigitalOcean Droplet
• Docker Compose
• Let's Encrypt SSL certificates
• Nginx reverse proxy
• Automatic container restart
• Redis persistence

📝 License

MIT License - See LICENSE file for details

🤝 Contributing

Contributions welcome! Please read CONTRIBUTING.md for guidelines.