← All projects
apps

Beluga Brawls

A full-stack Brawl Stars player and club tracking platform with temporal analytics. Battle history, club membership tracking, adaptive polling, and time-series statistics across a multi-view dashboard.

React 19TypeScriptFlaskPythonSQLiteDrizzle ORMDocker

Beluga Brawls is a player and club tracking application built on the Brawl Stars API. It collects and visualizes player statistics over time, tracking battle history, trophy progression, club membership changes, and brawler performance through a multi-view dashboard.

The backend uses a layered architecture — core (config, shared, database), services (auth, brawlstars, analytics, polling, discovery, data), and API — with an adaptive polling scheduler that adjusts request frequency based on player activity. The React 19 frontend provides multiple dashboard views with a theme system supporting dark, light, and default modes.

Deployed via multi-stage Docker builds to Fly.io with comprehensive debug logging throughout.