Wargame Platform

A browser-based turn-based strategy wargame platform inspired by 90s Talonsoft games (Eastern Front, Western Front, etc.). Build historical wargame scenarios with a data-driven, scenario-agnostic engine.

Tech Stack

• Backend: Elixir umbrella app + Phoenix + LiveView
• Frontend: PixiJS (2D) + Babylon.js (3D) + Solid.js (UI)
• Database: PostgreSQL

Project Structure

wargame_platform/
├── apps/
│   ├── wargame_core/          # Pure game logic
│   ├── wargame_ai/            # AI opponent
│   ├── wargame_persistence/   # Database layer
│   ├── wargame_matchmaking/   # Game sessions
│   ├── wargame_accounts/      # User management
│   └── wargame_web/           # Phoenix web interface

Development

See documents/development/plan.md for the full development plan.

Prerequisites

• Elixir 1.16+ / OTP 26+
• Node.js 20+ LTS
• PostgreSQL 16+
• pnpm (preferred) or npm

Setup

# Install dependencies
mix deps.get
cd apps/wargame_web/assets && pnpm install

# Setup database
mix ecto.setup

# Start the server
mix phx.server

Running Tests

# Run all tests
cd wargame_platform
mix test

# Run tests for a specific app
mix test apps/wargame_core/test
mix test apps/wargame_web/test

# Run a specific test file
mix test apps/wargame_core/test/wargame_core/map/tile_test.exs

# Run a specific test by line number
mix test apps/wargame_core/test/wargame_core/map/tile_test.exs:42

# Run tests with verbose output
mix test --trace

# Run only failed tests from previous run
mix test --failed

Documentation

• Development Plan
• Features
• Design Notes

First Scenario

Battle of Kursk (WWII Eastern Front) - A large-scale air and land battle at 1000m per hex scale.