Releases: mateuseap/chesskernel
Releases · mateuseap/chesskernel
Release list
v0.2.1 — Deploy infrastructure & CI fixes
What's changed
Bug fixes
- CI: typecheck and build jobs now correctly build
@chesskernel/sharedand runprisma generatebefore runningtsc— CI was failing on every push since v0.1.0 - Docker deploy: fixed multiple issues that made
docker compose upnon-functional:- Build contexts corrected (Dockerfiles expect the monorepo root, not
server/) Dockerfile.clientreferenceddocker/nginx/nginx.client.confwhich didn't exist — file added- Dead
client_buildvolume replaced with a properclientservice - Migrations now run automatically on server start via
docker-entrypoint.sh— no manualexecneeded after deploys
- Build contexts corrected (Dockerfiles expect the monorepo root, not
New
- Caddy TLS — add
DOMAIN=your.domain.comto.envand Caddy handles HTTPS + Let's Encrypt automatically .env.example— all required environment variables are now documented
Polish
- README board preview now uses the real cburnett piece SVGs from
react-chessboard, matching the home page exactly
Upgrading
git pull
docker compose -f docker/docker-compose.prod.yml up -d --buildMigrations run automatically on start.
v0.2.0 — Analysis UX, material count, classification badges, docs
What's new in v0.2.0
UI Improvements
- Material count — real Cburnett SVG piece icons next to player names, showing captured pieces +
+Xmaterial advantage - Classification badges — rebuilt as a standalone SVG overlay; badges always render regardless of arrow state; correct chess.com-scale sizing
- Eval bar — widened to 20px, vertical score label, border for light-theme legibility, pure black/white text
- Illegal move animation — chess.com-style shake + red glow on rejected moves
- Feature carousel — homepage features section redesigned as infinite-scroll ticker; pauses on hover; edge fade masks
Frontend
- Hero tagline ("Open Source · Free Forever") moved to i18n — now translatable in EN/PT/ES
- Removed "Self-Hosted" feature card from homepage
analysis.descriptionandanalysis.startingkeys added to all locales (no more hardcoded EN strings on the analysis page)
Infrastructure
- CI pipeline fixed (pnpm version field conflict resolved)
- Stale CJS artifact cleanup in shared/src
Documentation
- All docs updated with Mermaid diagrams (sequence, state machine, ER diagram, flowcharts)
- New:
docs/frontend/architecture.md— component tree, data flow, i18n guide - New:
docs/security/security.md— threat model, auth flow, move validation, rate limiting - README redesigned with centered chess board SVG, badge row (CI/version/license/stars/visitors), marketing copy, quick-start
Full changelog: v0.1.0...v0.2.0
v0.1.0 — Initial production release
ChessKernel v0.1.0
First production-ready release. Self-hosted chess platform — no external paid dependencies.
Features
Gameplay
- Real-time multiplayer via Socket.IO
- Bot games against Stockfish (easy / medium / hard / max)
- Move clock with configurable time controls (bullet / blitz / rapid / classical)
- Full castling support — including king-to-rook drag (chess.com convention)
- Resignation, draw offer / accept / decline
- Page-refresh reconnect without auto-loss
Analysis
- Post-game Stockfish analysis (depth 20)
- Move classification with chess.com-exact colors: brilliant, great, best, book, inaccuracy, mistake, blunder
- Classification badges on the board's destination square
- Eval bar that tracks exact board height (CSS Grid)
- Best-move arrow overlay for non-optimal moves
- L-shaped SVG arrows for knight-move annotations (right-click drag)
Social & Ranking
- Glicko-2 rating system per time control
- ELO-based matchmaking queue
- Friend system (request / accept / remove)
- Token-based game invitations (shareable link)
- Leaderboards per time control
- In-app notifications
Platform
- i18n: English, Portuguese, Spanish
- Dark / light theme
- Responsive layout
- Docker Compose production stack (Nginx, PostgreSQL, Redis, NestJS, React)
Getting Started
git clone https://github.com/mateuseap/chesskernel.git
cd chesskernel
cp .env.example .env # fill in secrets
docker compose -f docker/docker-compose.prod.yml up -d
docker compose -f docker/docker-compose.prod.yml exec server npx prisma migrate deploySee Deployment Guide for full instructions.
Requirements
- Docker 24+ and Docker Compose 2+
- Stockfish 15+ (on host or container)