Skip to content

Releases: mateuseap/chesskernel

v0.2.1 — Deploy infrastructure & CI fixes

Choose a tag to compare

@mateuseap mateuseap released this 02 Jul 04:13
df23245

What's changed

Bug fixes

  • CI: typecheck and build jobs now correctly build @chesskernel/shared and run prisma generate before running tsc — CI was failing on every push since v0.1.0
  • Docker deploy: fixed multiple issues that made docker compose up non-functional:
    • Build contexts corrected (Dockerfiles expect the monorepo root, not server/)
    • Dockerfile.client referenced docker/nginx/nginx.client.conf which didn't exist — file added
    • Dead client_build volume replaced with a proper client service
    • Migrations now run automatically on server start via docker-entrypoint.sh — no manual exec needed after deploys

New

  • Caddy TLS — add DOMAIN=your.domain.com to .env and 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 --build

Migrations run automatically on start.

v0.2.0 — Analysis UX, material count, classification badges, docs

Choose a tag to compare

@mateuseap mateuseap released this 02 Jul 03:47
fe304d7

What's new in v0.2.0

UI Improvements

  • Material count — real Cburnett SVG piece icons next to player names, showing captured pieces + +X material 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.description and analysis.starting keys 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

Choose a tag to compare

@mateuseap mateuseap released this 01 Jul 19:12
954485b

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 deploy

See Deployment Guide for full instructions.

Requirements

  • Docker 24+ and Docker Compose 2+
  • Stockfish 15+ (on host or container)