A React-based chess game featuring multiple unique game modes inspired by various gaming cultures. Each mode introduces new rules, mechanics, or strategic twists on the classic game.
This application is 100% frontend — no backend, no database, no account required.
Play directly in your browser: chess.jeremy-maisse.com No installation needed — just open the link and start playing!
- Multiple game modes — Classic, Borderless, All Random, Assimilation.
- Solo & vs AI — Play both sides yourself or face Stockfish at 10 difficulty levels (Beginner to Superhuman). In special modes, a smart fallback chain ensures the AI always plays a legal move even when Stockfish suggests a move that violates special-mode rules.
- P2P multiplayer — Challenge a friend remotely via a shareable link, with no server involved (WebRTC).
- Classic chess rules — Castling, pawn promotion, check detection, stalemate.
- Visual indicators — Highlighted valid moves, selected piece, king in check (orange), assimilated pieces (green glow).
- Assimilation mode — Pieces permanently acquire the movement abilities of pieces they capture; accumulated abilities visualised via hover tooltip.
- Multilingual UI — English, French, Spanish, Italian, Arabic, Japanese, Chinese, Korean.
- Feedback form — Send feedback directly from the Settings modal; generates a pre-filled mailto link, no backend needed.
- Installable as a PWA — Add to home screen for quick access.
- Endgame statistics — Match duration, move count, AI level, rematch option.
- Player profile — Persistent stats page (
/profile) with activity heatmap, win rate donut, ELO rank, favorite pieces, mode distribution, and unlockable achievements. All stored locally — no account required.
| Mode | Description |
|---|---|
| Classic | Standard chess with all classic rules. |
| Borderless | Pieces can cross board edges and reappear on the other side. |
| All Random | Pieces are placed randomly at game start. |
| Assimilation | A piece that captures another permanently acquires its movement abilities (cumulative). |
To run the game locally:
- Clone the project
git clone https://github.com/One-djey/chess_verse.git
- Navigate to the project folder
cd chess_verse - Install dependencies
npm install
- Start the development server
npm run dev
The project is covered by automated tests (Vitest + Testing Library), run in CI on every push/PR:
npm run test # run the full suite once
npm run test:watch # watch mode
npm run test:coverage # with coverage thresholds on core modules- Full QA strategy and test-case catalog:
docs/TEST_STRATEGY.md - Known bugs & technical debt registry (causes, locations, recommended fixes):
docs/KNOWN_ISSUES.md
- React 18 — UI framework
- TypeScript — Type safety
- Vite — Build tool and dev server
- Tailwind CSS — Styling
- Stockfish — Chess AI engine (WebAssembly Web Worker)
- Trystero — P2P connection via WebRTC (no signalling server)
- react-i18next — Internationalisation
Contributions to enhance the game are welcome!
- Fork the repository and create a branch.
- Add a
rulesflag toGameModeinsrc/types/chess.ts. - Register the mode in
src/components/GameModes.tsx(gameModes[]array). - Implement movement or board logic in
src/utils/chess/moves.ts(guard ongameMode.rules). - Add translations for the mode title and description in every
src/i18n/locales/*.jsonfile. - Write the tests — every code change must ship its unit tests in the same commit (see
docs/TEST_STRATEGY.md§8 for the policy); check that all other modes are unaffected. - Submit a pull request describing the mode and its gameplay changes. CI (lint + tests + coverage thresholds + build + e2e) must be green.
This project is licensed under the MIT License.