Bracket

Bracket is an open-source, self-hosted application for organizing and managing sports competitions. It provides tools to structure tournaments, manage participants, and track match progress through a web-based interface. The software is deployed as a server application and can be run using Docker or manually via Python and Node.js. It is designed to handle the logistics of competitive events from the initial setup of teams to the final determination of winners.

The system supports various competition styles and allows administrators to define complex tournament structures. It includes a backend for data management and a frontend for both administrative control and public display of results. Users can manage multiple clubs and assign various tournaments to each club, making it suitable for organizations that oversee multiple sporting disciplines or recurring events. The interface allows for the creation of teams and the assignment of specific players to those teams.

Key features

• Supports single elimination, round-robin, and swiss formats
• Custom tournament structures with multiple stages and groups
• Drag-and-drop match rescheduling and court assignment
• Publicly accessible dashboard pages with logo customization
• Management of clubs, teams, and individual players
• Dynamic match scheduling for swiss tournaments
• Multi-language support with automatic browser detection

The application is built with a FastAPI backend using async Python and a React frontend utilizing Vite and the Mantine library. It uses PostgreSQL for data storage and is configured via environment variables or .env files. The architecture allows for the creation of multiple clubs, each hosting its own set of tournaments and teams. For deployment, the software provides a docker-compose configuration that orchestrates the backend, frontend, and database instances. It also includes a command line interface for tasks such as inserting dummy data for development and testing purposes.

Bracket is designed for sports organizers and club administrators who require a self-hosted system to manage competitive brackets and tournament logistics.