Chess

Modern Chess is a two-player chess experience with a Next.js frontend, a Node.js WebSocket server for real-time multiplayer, and a dedicated REST API server for account/auth operations.

A working version of this game can be found here: https://chess-championship-arena.vercel.app/

Repository Structure

• client/ — Next.js frontend (App Router)
• ws-server/ — Node.js WebSocket server (TypeScript, ws)
• api-server/ — Node.js REST API server (Fastify, Zod, Prisma, PostgreSQL, TypeScript)

Quick Start

Frontend (Next.js)

1. Install dependencies:
   • From client/:
     • pnpm install (recommended)
     • or npm install
2. Start the dev server:
   • pnpm dev or npm run dev
3. Open http://localhost:3000

WebSocket Server (Node.js)

1. Install dependencies:
   • From ws-server/:
     • pnpm install
2. Start the server:
   • pnpm dev (recommended for development)
   • or pnpm build && pnpm start
3. The server listens on ws://localhost:8080 by default.

Health check: http://localhost:8080/health

API Server (Node.js)

1. Install dependencies:
   • From api-server/:
     • pnpm install
2. Start the server:
   • pnpm dev (recommended for development)
   • or pnpm build && pnpm start
3. The server listens on http://localhost:4000 by default.
4. Run migrations before first start:
   • pnpm prisma:migrate:dev

Health check: http://localhost:4000/health

Docker (Full Stack)

From the repository root:

• docker compose up --build

This starts:

• WebSocket server on ws://localhost:8080
• API server on http://localhost:4000
• Frontend on http://localhost:3000

Documentation

• CONTRIBUTING.md

License

This project is licensed under the MIT License. See LICENSE for details.