Files
WilliamSoderberg Verified 9d571e59cb
CI/CD Pipeline / test-backend (push) Failing after 4s
CI/CD Pipeline / test-frontend (push) Successful in 13s
CI/CD Pipeline / build-docker (backend) (push) Has been skipped
CI/CD Pipeline / build-docker (frontend) (push) Has been skipped
Updated README with new pictures
2026-07-11 18:59:01 +02:00

125 lines
3.1 KiB
Markdown

<div align="center">
# VolleyManager
### A modern tournament management system built with Flask & Tailwind CSS
<i>Works perfectly on mobile and desktop</i>
<br>
<img src="https://img.shields.io/badge/Python-3.14-blue?style=for-the-badge&logo=python" height="25">
<img src="https://img.shields.io/badge/Flask-3.1.3-lightgrey?style=for-the-badge&logo=flask" height="25">
<img src="https://img.shields.io/badge/Tailwind_CSS-4.1.18-38B2AC?style=for-the-badge&logo=tailwind-css" height="25">
</div>
<br>
## Dashboard & Controls
The central hub for managing tournaments.
<img src="./docs/bracket-light.png" width="100%" alt="Brackets">
---
### Mobile Friendly
Seamless support for both PC and mobile users.
<div align="center">
<img src="./docs/dashboard.png" width="70%" alt="Dashboard">
<img src="./docs/mobile-dashboard.png" width="16%" alt="Mobile Friendly">
</div>
---
## Tournament Management
### Setup & Creation
<div align="center">
<img src="./docs/tournament-new.png" width="48%" alt="New Tournament">
<img src="./docs/tournament-edit.png" width="48%" alt="Edit Tournament">
</div>
### Bracket Visualization
Dynamic bracket generation handling various tournament sizes and with seamless support for both light and dark environments.
<div align="center">
<img src="./docs/bracket-dark.png" width="48%" alt="Bracket Dark">
<img src="./docs/bracket-light.png" width="48%" alt="Bracket Light">
</div>
### Bracket Variants
**Single Elimination & Live Scoring**
<div align="center">
<img src="./docs/single-elimination.png" width="48%" alt="Single Elimination">
<img src="./docs/scoring.png" width="48%" alt="Scoring">
</div>
---
## Scheduling & Results
Automated scheduling views with real-time score updates.
<div align="center">
<img src="./docs/schedule.png" width="70%" alt="Schedule">
<img src="./docs/mobile-schedule.png" width="16%" alt="Schedule - Mobile Friendly">
</div>
---
## Court Overview
Keep up with all courts all at once in one place.
<img src="./docs/courts.png" width="100%" alt="Schedule">
---
## Role-Based Scoring
Secure scoring interfaces for Referees and Administrators.
<table>
<tr>
<td width="50%" valign="top">
<img src="./docs/score-ref.png" width="100%" alt="Referee View">
</td>
<td width="50%" valign="top">
<img src="./docs/score-admin.png" width="100%" alt="Admin View">
</td>
</tr>
<tr>
<td valign="top">
<h3> Referee View</h3>
<p>
<b>Restricted Access</b><br>
Referees must enter a tournament code to submit scores.
<b>Note</b>: Clear only appears if scores are already submitted.
</p>
</td>
<td valign="top">
<h3> Admin View</h3>
<p>
<b>Full Access</b><br>
Admins are free to submit, edit, or override scores at any time without codes.
</p>
</td>
</tr>
</table>
## Admin login
Secure settings behind a admin login.
<img src="./docs/admin.png" width="100%" alt="Dashboard Admin">
## Deploy
Clone the repo and run the docker-compose or create your own. Create a .env file with your custom values there is an example.env available.