Inspiration
The idea for this project came from conversations with my mom, who plays in a casual tennis league called T2. The league has its own rating system and is much more relaxed than traditional competitive leagues, which makes it accessible and fun. However, it only operates out of Atlanta and Denver, so matches often require long drives.
My family is from Calhoun, Georgia, about 1.5 hours outside of Atlanta. Seeing how far players had to travel made me realize how many smaller communities could benefit from having something similar locally. I wanted to create a system that makes it easy for towns to run relaxed, community based tennis leagues without the overhead or travel burden of larger city leagues.
The long term goal is to help more people get out and play more often, using sports as a way to bring communities closer together.
What it does
Calhoun Tennis League Scheduler is a web application that manages a local doubles tennis league from start to finish. Teams of 2 players sign up with ratings and availability, and the app automatically generates a fair 5 week schedule where each team plays exactly 5 matches.
The app tracks match results, updates standings based on win loss record, and displays Elo ratings as a secondary metric. Points for and against are calculated using normal set games, while match tiebreaks count as 1 or 0 to keep standings realistic. At the end of the regular season, the top 4 teams automatically advance to a playoff bracket.
For demonstration and testing, the app also includes simulation tools that can instantly create a 10 team league, simulate results week by week, simulate a full season, and simulate playoffs.
How I built it
The project was built using React and Vite with JavaScript. The focus was placed on league logic rather than visuals. Scheduling is generated using a round based approach to ensure fairness and consistency, with availability and home courts used to assign times and locations when possible.
Standings are computed dynamically from match results, with careful separation between win loss rankings and Elo ratings. Simulation features reuse the same scoring and Elo logic as real match entry, ensuring consistent behavior across the app.
Challenges I ran into
One major challenge was scheduling logic. Early versions of the scheduler accidentally allowed teams to play more than 5 matches. This was resolved by switching to a round based structure that strictly limits the season length.
Another issue involved scoring accuracy. Match tiebreaks were initially counted the same as normal set games, which inflated points for and against. The scoring logic was updated so match tiebreaks only count as 1 point for the winner and 0 for the loser.
Managing state consistency between scheduling, results, Elo updates, standings, and simulations also required careful handling to prevent desynchronization.
Accomplishments that I'm proud of
Building a complete league workflow from team creation to playoffs within a short hackathon timeframe Generating a schedule where each team plays exactly 5 matches with no duplicates Accurately handling match tiebreaks without distorting standings Creating simulation tools that make the full system easy to demo and test
What I learned
This project highlighted how much complexity exists in even small league systems. Details like scheduling constraints and scoring rules have a big impact on fairness and usability.
I also learned the value of building demo friendly features. The simulation tools made it much easier to test edge cases and clearly demonstrate the project in a limited judging window.
What's next for Calhoun Tennis League Scheduler
The next step is expanding this into a platform where any town can create its own league instance. Future work includes user accounts, league creation flows, mobile friendly design, support for other sports, and hosting the service so communities can easily spin up leagues without technical setup.