Free chess with friends or a computer opponent. Create a game, share its link, and play without an account.
Play at yourmove.fun · Development guide · Mobile app
Your Move includes a React website and an Expo app for iOS and Android. Both clients use the same Go API. Available features include:
- Play a friend. The first two visitors take the seats. Everyone else can watch and send emoji reactions.
- Play the computer. Choose Pip, Snobal, Ada, Viktor, or Gibson the Gray, then choose White or Black. All five opponents start unlocked. Custom difficulty sets an approximate Elo target instead.
- Make your move. Tap or click to move. The website also supports drag and drop. Both boards show legal destinations, the last move, check, and captured pieces.
- Keep the game close. Share links, flip the board, read move notation, and reopen recent games with win, loss, or draw results.
- Make it yours. Choose light or dark mode and six board colors: Matcha, Lilac, Peach, Teal, Sky, and Rose.
- Return to your seat. The same browser or app installation retains your anonymous identity. With Postgres, games and seats survive server restarts.
Arasan runs on your device through WebAssembly. The Go server validates and saves moves, so computer games still require an API connection. The computer opponents guide explains the engine, opponent behavior, and build requirements.
The chess coach is a Coming soon preview on the home screen. It does not provide advice or call a coach API.
A live friend game, with legal destinations, captures, reactions, and move notation:
The website also adapts to phone screens:
| Choose an opponent | Play Ada | Watch in dark mode |
|---|---|---|
 |
 |
 |
A completed game
These screenshots show the local website with real games. Phone screenshots show the responsive website, not the native app. The screenshot guide includes the capture script and refresh instructions.
Requirements: Go 1.24+, Node 22.13+ (Node 24 recommended), Corepack, Make, Git, patch, and Emscripten 4.0.14.
Postgres is optional. The workspace pins pnpm 9.15.0.
-
Install the workspace dependencies:
make bootstrap
-
With Emscripten 4.0.14 active in your shell, build the engine assets:
corepack pnpm@9.15.0 engine:build
-
Start the API:
make dev-api
-
In another terminal, start the website:
make dev-web
-
Open localhost:5173.
Vite forwards API requests to port 8080. The engine build downloads pinned Arasan sources and generates the web and mobile assets. Production web builds require these assets. Docker and CI include the Emscripten toolchain.
For web and mobile development together, run make dev after the dependency and engine steps.
This command starts the API, Vite, and Expo.
The mobile guide covers Expo Go, device previews, and installable Android builds.
For a phone that cannot reach the default API host, set EXPO_PUBLIC_API_URL to your development machine's LAN address.
EXPO_PUBLIC_WEB_URL controls the origin of shared web links.
Before you start the API, set DATABASE_URL to a Postgres database:
export DATABASE_URL="postgres://user:pass@localhost:5432/yourmove?sslmode=disable"Postgres saves games and seats before the server acknowledges changes. Without Postgres, games disappear after a server restart. Anonymous seat recovery requires the original browser data or app installation. A shared game link does not transfer your seat.
After the dependency and engine steps, run the checks from the repository root:
| Command | Coverage |
|---|---|
make typecheck |
Shared packages, web, and mobile TypeScript |
corepack pnpm@9.15.0 test |
Shared chess logic and client utilities |
make test |
Production web build and Go tests |
corepack pnpm@9.15.0 engine:test |
Actual Arasan WASM runtime |
E2E_RECORD=0 make test-e2e |
Complete legal games in two browser clients |
With the API and Vite servers active, run the web browser suite:
corepack pnpm@9.15.0 --filter @yourmove/web test:e2eThe Playwright suite requires Google Chrome. It covers computer opponents, friend games, spectators, themes, captures, reactions, recent games, and recovery.
The full-game Go suite accepts Chrome or Chromium through CHROME_BIN.
The development guide covers Postgres integration tests and the race detector.
| Path | Purpose |
|---|---|
| web/ | React, TypeScript, and Vite website |
| apps/mobile/ | Expo and React Native app |
| packages/chess/ | Shared chess helpers and computer opponent policy |
| packages/protocol/ | Shared TypeScript wire types |
| packages/coach/ | Deterministic policy for the planned coach |
| engine/arasan/ | Pinned engine build, runtime checks, and tuning tools |
| internal/ | Go game logic, API handlers, and storage |
| docs/ | Development, deployment, protocol, and design documents |
The server validates moves with github.com/corentings/chess/v2. Both clients receive live game state and emoji reactions through Server-Sent Events (SSE).
The web engine uses a Web Worker. The native engine uses a bundled WebView.
The GitHub Actions workflow deploys successful main builds to DigitalOcean App Platform.
The app spec serves the website as static files and the Go API as a separate Docker service.
Live event delivery requires one API instance, including deployments with Postgres.
The deployment guide covers DigitalOcean, Docker images, database configuration, and Android APKs. Further design details are in architecture, protocol, and the coach plan.
Your Move uses the MIT license. Arasan and bundled engine dependencies have separate terms in third-party notices.