Mixmaker
Mixmaker is a full-stack application for organizing Overwatch community scrims: Discord authentication, role ratings and preferences, RU/EN UI, event RSVP, preference-aware balanced 1/2/2 teams, captain assignment, Bo3 drafts and results, and a single-elimination bracket.
Stack
- Go backend with Clean Architecture
- PostgreSQL
- React, TypeScript, Vite, TanStack Query and Router
- REST + Server-Sent Events
- Docker Compose for local PostgreSQL and Coolify production deployment
Local development
Requirements: Go, Node.js/npm, Docker with Compose.
cp .env.example .env
make dev-db
make migrate
# Terminal 1
make backend
# Terminal 2
make frontend
The frontend runs at http://localhost:5173; API requests are proxied to the backend. To use the real API locally, copy frontend/.env.example to frontend/.env and set VITE_DEMO_MODE=false.
Create a Discord application, add the callback URL from DISCORD_REDIRECT_URL, and fill in DISCORD_CLIENT_ID, DISCORD_CLIENT_SECRET, and ADMIN_DISCORD_IDS.
Checks
make test
make lint
make compose-check
Production
The root compose.yaml is designed for a single Coolify Docker Compose resource. Coolify owns routing and networking; the file intentionally does not declare custom networks or publish PostgreSQL.
See deployments/coolify.md for setup, secrets, storage, and backup requirements.
Product documentation
Current decisions and domain rules live in memory_bank/.