project  -  v0.3.2

GoStrategy

WebSocketsGo ConcurrencyNixOS Deployment

An open-source re-engineering of the classic GoStrategy board game. Features a high-performance Go backend with WebSockets, a modern SvelteKit client, strategic heuristic AIs, and declarative NixOS deployment.

SvelteKit Go TypeScript Tailwind PostgreSQL Docker NixOS
GoStrategy
Read about the project below

Re-Engineering a Classic

GoStrategy modernizes the traditional strategic board game into an extensible, high-performance platform. It is engineered not just for human-vs-human play, but as a robust testing ground for real-time game simulation and strategic AI model training.


Technical Architecture & Core Pillars

High-Performance Go Backend

  • Concurrency-First Game Engine: Leverages Go’s lightweight goroutines and channels to run isolated, concurrent game loops. Each active match is handled as a lightweight thread, communicating with client sessions via persistent WebSockets.
  • Decoupled CLI & Headless Training: The backend can run fully headless to train and benchmark AI strategies at maximum CPU clock speeds, completely independent of the visual DOM.
  • Robust Quality Assurance: Key board rules, piece movement algorithms, and battle resolution matrices are covered by a dense suite of Go unit tests to prevent regressions.

SvelteKit Client-Side Frontend

  • Reactive & Atomic UI: Built using SvelteKit and TypeScript. The UI bypasses heavy SSR in favor of a fast, client-side SPA architecture, styling exclusively with a custom-themed Tailwind system.
  • Interactive Custom Assets: Designed playful, modern battlefield pieces inspired by the Go “Gopher” mascot. Standard ranks are updated to modern counterparts (e.g., tanks, IT specialists, and mortars) while keeping the original game mechanics intact.

Strategic AI Integration

  • FAFO (Random Strategy): The baseline “F*ck Around and Find Out” AI. Executes random valid moves to serve as a pure stochastic control reference.
  • FATO (Heuristic Strategy): The “F*ck Around and Try Out” AI. Evaluates board layout metrics and applies static heuristics to prioritize offensive, defensive, and capture-oriented paths before falling back on random moves.

Declarative Infrastructure & CD

  • Docker Containerization: Multi-stage Docker builds isolate backend binaries and frontend assets, minimizing execution footprints and ensuring parity across development and production.
  • NixOS Hosting & CD: Deployed deterministically on a self-hosted NixOS VM via a Proxmox virtualized environment. Git pushes trigger an automated CI/CD pipeline that builds, tests, and deploys the stack seamlessly.


Asset & Character Designs

The custom blue battlefield pieces, ranging from IT specialists to high-ranking Marshals.
The corresponding custom red team pieces.

Meet the AIs

FAFO

Purely random gameplay for baseline metrics.

FATO

Heuristics-driven strategic decision-making.

ennl