Chess

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
2. Start the dev server:
   • pnpm 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

Documentation

• CONTRIBUTING.md

License

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

This site is open source. Improve this page.