kettleofketchup-draftforge

Draftforge

A tournament management platform for Dota 2 gaming communities.

Website: dota.kettle.sh

Documentation: kettleofketchup.github.io/DraftForge

Table of Contents

• Features
• Tech Stack
• Quick Start
• Screenshots
• Demo Videos
• Development

Features

Status	Feature	Description
:white_check_mark:	Tournament Brackets	Single/double elimination and round-robin with automatic bracket generation
:white_check_mark:	Team Draft System	Snake, Normal, and Shuffle draft modes balanced by MMR for 40+ player drafts
:white_check_mark:	Hero Draft	Real-time Captains Mode hero picking with spectator view, timers, and pick/ban tracking
:white_check_mark:	Match Tracking	Steam API integration for match statistics
:white_check_mark:	Telemetry	Structured logging with structlog and optional OpenTelemetry tracing
:white_check_mark:	CSV Import	Bulk-add users via CSV upload with conflict detection and team assignment
:soon:	Team Management	Create and manage rosters, track player stats, and coordinate with Discord
:soon:	League System	Season-based competitive leagues with ELO ratings and standings
:soon:	Discord Integration	Server syncing for rosters and tournament announcements
:soon:	Auction Draft	Captain nomination bidding with salary caps and real-time WebSocket auctions

Tech Stack

Layer	Technologies
Frontend	React 19, TypeScript, Vite, TailwindCSS, Radix UI
Backend	Django 5, Django REST Framework, Daphne (WebSockets), Celery (distributed task workers)
Infrastructure	Docker, Nginx, Redis (caching)
Observability	Sentry (error tracking & session replay), structlog, OpenTelemetry (opt-in)
Auth	Discord OAuth, authenticated WebSockets

graph LR
    Client([Browser]) -->|HTTPS| Nginx

    subgraph Backend
        Django[Django]
    end

    subgraph Frontend
        React[React]
    end

    Nginx -->|/api/| Backend
    Nginx -->|/*| Frontend

    subgraph Data
        Redis[(Redis)]
        DB[(SQLite / Postgres)]
    end

    subgraph Workers
        Celery[Celery]
        DiscordBot[Discord Bot]
    end

    Backend --> Data
    Backend -.->|tasks| Workers

    subgraph Observability
        Sentry[Sentry]
        OTel[OpenTelemetry]
    end

    Backend --> Observability
    Frontend --> Observability

Quick Start

Run everything locally with populated test data:

git clone https://github.com/kettleofketchup/draftforge.git
cd draftforge
./dev              # Install just, create venv, install deps
poetry install     # Install Python dependencies
just test::setup   # Build images, migrate, populate test data, start stack

Open https://localhost when ready.

Screenshots

Home	Tournaments	Tournament Detail	Bracket

Demo Videos

Automated demo recordings are available for key features:

Captain 1 - HeroDraft	Captain 2 - HeroDraft
Full Video	Full Video

Shuffle Draft	Snake Draft
Full Video	Full Video