Skip to main content
ShirePath Solutions

Drawing 02.1, league platform

Advantage Sports

The software that runs the Advantage Flag League, about 1,500 families a season: registration, the payment ledger, team formation, schedules, standings, and messages to families. Built from scratch for one league.

VercelNeonAWSAWSHTTPSpresigned PUTbearer tokenpage imagesjobs, leasespages, mailread mail, draftsmail, SMSRunTaskresults123456789BrowserChecks bucketLambda rendererNext.js onVercelNeon PostgresClaudeMicrosoft 365Schedule solverSendGrid,TwilioVercelNeonAWSAWSHTTPSpresigned PUTbearer tokenpage imagesjobs, leasespages, mailread mail, draftsmail, SMSRunTaskresults123456789BrowserChecksbucketLambdarendererNext.js onVercelNeonPostgresClaudeMicrosoft365SchedulesolverSendGrid,Twilio
Fig. 1. How the league's checks, schedules, and email run, and where each piece runs.
Parts list for Advantage Sports
No.PartWhat it does here
1BrowserFamilies register and owe a balance; admins upload check deposits and confirm matches; the inbox owner reviews drafted replies.
2Checks bucketPrivate S3: deposit PDFs the browser uploads by presigned URL, and the page images rendered from them.
3Lambda rendererA Lambda container that renders each deposit page to an image with pdfjs-dist and @napi-rs/canvas, behind a shared-secret token.
4Next.js on VercelPages, server actions, eleven crons, and a job worker that runs steps on a time budget and then calls itself for the rest.
5Neon PostgresLeague data and the payment ledger through Drizzle, the job table and its leases, and the inbox's threads, drafts, and audit rows.
6ClaudeReads each check on a page; sorts new info@ mail and drafts replies from read-only league lookups, with no tool that writes or sends.
7Microsoft 365The league's info@ mailbox: read every five minutes by Graph delta; an approved reply lands in Drafts, and a person sends it from Outlook.
8Schedule solverA one-shot Fargate Spot task that builds the season's schedule and writes it to Postgres.
9SendGrid, TwilioSign-in codes, notices, and blasts by email, and texts behind a kill switch.

Why it exists

The Advantage Flag League is a youth flag football league with volunteer coaches and a new season of registrations every year. It ran on Sports Connect, which has since reached end of life, and nothing off the shelf fit how the league actually works. Most families pay by paper check, and those checks were keyed in one at a time, about thirty seconds each, in batches of fifty to seventy. Sorting players into fair teams took 20 to 30 hours of spreadsheet work. Advantage Sports is the software built to replace all of it. It started as League-OS; the Advantage Sports name is for the day other leagues run on it too.

How it works

Families register online and see a running balance. The league takes no cards, so checks, Zelle transfers imported from the bank's file, cash, and money orders all land in one ledger.

For checks, an admin scans a batch into one PDF and uploads it. A separate service turns each page into an image, and Claude, an AI model, reads every check on it: who paid, how much, and the check number. Each check is matched to a registration and checked for duplicates. Strong matches confirm themselves, an admin reviews the rest, and only then are the payments posted to the ledger.

A batch can take longer than one web request is allowed to run, so the work is split into steps saved in the database. A worker does as many steps as fit in its time limit and hands the rest to a fresh run, and a check every five minutes restarts anything that stalled.

Team formation is the other heavy job. The solver builds teams in three passes: a quick first draft, many small swaps that each make the teams fairer (a method called simulated annealing), then a repair pass. Friend requests and keeping schoolmates together come first, then balance by grade and quarterbacks, and every kid is checked for at least one familiar face on the roster. An admin can ask for a change in plain words, like keeping two brothers together. Claude turns it into rule changes for the admin to review before a fresh run, and never places a kid itself. It also explains what changed between two runs, nothing goes live until an admin accepts one, and coaches see their teams before families do.

The league's email inbox runs through the app too. Every five minutes it reads new mail in the league's Microsoft 365 inbox and sets automated and vendor mail aside before any model sees it. Claude sorts the rest by who needs to handle it, and some subjects always go to the inbox owner whatever the model thinks, such as refunds, injuries, custody, and complaints. When a message can be answered from league data or needs an admin step, Claude drafts a reply from read-only lookups of the family's records and the league's published schedules, policies, and answers, and any claim it cannot back with a lookup is flagged. A draft reaches Outlook only after the inbox owner approves it, and a person sends it from there. The app has no permission to send mail from that inbox.

A season on it

Fall 2026 is the first season the league runs on Advantage Sports instead of Sports Connect. The season's calendar: registration opened April 1, and check and Zelle payments come in from then through the season. The solver was ready by May 15 and the teams were formed by June 1. The schedule was posted by August 1, games run from August 14 to week 9 on October 16, and Championship Night closes the season on October 23.

A season runs on nine clocks

A season is not one switch from open to closed. It has a status, plus separate windows and switches that each move on their own: registration, the coaches' freeze forms, uniform sizes and numbers, family requests about teammates, schedule requests, the release of each team to its coach and then to families, the weighted standings, and the playoffs. An admin opens and closes each one, and families see the closing date of every window that lets them change something. The league keeps a written operating model of what happens each season and what goes stale when a step is missed, so the person running the season does not have to hold it all in their head.

What it changed

  • It serves about 1,500 families a season.Source: Conner's league records, confirmed 2026-10-13

What it does

  • Registration with a running balance for each family
  • One ledger for checks, Zelle, cash, and money orders
  • Check deposits read by Claude, matched, and confirmed by an admin
  • A team-formation solver, steered in plain words and compared run by run
  • Season schedules built by a solver task on AWS
  • Email and text blasts, with lanes families unsubscribe from separately and STOP by text honored
  • An assistant for the league's email inbox: Claude sorts each message and drafts a reply, and a person approves it and sends it from Outlook
  • Waitlists, and scholarship waivers at registration

Screenshots

The Advantage Flag League site at ylafl.com
Plate 1. The league it runs.
The Advantage Sports site at joinadvantagesports.com
Plate 2. For other leagues.

Something like this on your list? Tell us about it.

Talk about a build like this