Every registration season, Little League board members face the same tedious task: verifying that each player’s address falls within the league’s official boundaries. With over a thousand registrations, manually checking each address against the Little League Finder becomes a time sink that takes volunteers away from what matters—getting kids on the field.
The Problem
The Little League Finder is the official tool for boundary lookups, but it’s designed for one address at a time. For a league with 1,000+ players across multiple divisions, that means:
- Hours (or days) of manual data entry
- Copy-pasting addresses from spreadsheets
- Recording results somewhere (hopefully not on sticky notes)
- Doing it all over again when late registrations come in
The Solution
I built Little League Boundary Verifier—an open-source tool that automates the entire process. Point it at your registration spreadsheet, and it checks every address against the official Little League Finder, flagging any that fall outside your boundaries.
How It Works
The tool uses browser automation (Playwright) to interact with the Little League Finder exactly like a human would—entering each address, selecting your sport, and checking if your league appears in the results. It handles rate limiting gracefully and runs each division in parallel via GitHub Actions.
Key Features
- Google Sheets integration: Connects directly to your registration spreadsheet
- Parallel processing: Runs all divisions simultaneously using GitHub Actions matrix
- Privacy-safe: Only shows pass/fail counts in public job summaries—no player names or addresses exposed
- Rate limit handling: Automatically waits and retries when the lookup tool gets overwhelmed
- Works for any league: Just configure your league name and division structure
Getting Started
- Fork the repository at github.com/whyisjake/little-league-boundary-verifier
- Add your Google Sheets credentials as repository secrets
- Update the divisions in the workflow file to match your league
- Run the workflow and check the results
The README has detailed setup instructions, including how to create a Google Cloud service account for Sheets access.
Built for Volunteers, By Volunteers
Little League runs on volunteer power. Every hour saved on administrative tasks is an hour that can go toward coaching, field maintenance, or just watching kids have fun playing baseball and softball.
If you’re on a league board and spending too much time on boundary verification, give this tool a try. And if you improve it, pull requests are welcome!
Leave a Reply