❗ This project is still in the early stages of development and should be considered highly unstable. Expect bugs, weird behavior, and bad code. (see #1)

Online 2-player chess. Live demo at


This repository is used for production deployments. You will need to make changes to the configuration to get this running locally.

npm install # install all dependencies

npm run dev # concurrently run frontend and backend dev servers

npm run react-dev # run frontend server only

Environment variables

Client: APIURL (or just change apiUrl in /client/src/config/config.ts)

Server: PORT, SESSION_SECRET, PGUSER, PGPASSWORD, PGHOST, PGDATABASE, PGPORT (also see server cors config and session middleware for local development)


View Github