The complete manual for the Racket Leagues app — from creating an account through running a full box-league season. This guide covers what every screen does, who can do what, and how to find the setting you need.
Note
Screenshots are being added throughout the guide as we polish the v1.0 release. The written instructions are complete and current.
Getting started
Overview
Racket Leagues is a multi-club, multi-sport box-league and ladder app. A club is a group of players run by a super-admin. Members of a club can opt into leagues — the app runs the rounds, handles promotion and relegation, and keeps all the standings up to date.
Three roles shape what you can see and do:
Player — join leagues, record and confirm results, see standings.
Admin — everything a player can do, plus approve photos, override disputed results, and help run rounds.
Super-admin — full control of the club: branding, sports, members, league lifecycle, and transferring ownership.
One person can play in more than one club at the same time, and one person can be a player in one club while being an admin in another. The app groups everything together on the home screen.
Create an account
Tap Create account on the welcome screen. You'll be asked for an email address, a password, and a display name. Your display name is what other players see — you can change it later.
The sign-up form. Email, password, and a display name — nothing else required.
After you sign up, Racket Leagues sends a verification email. Tap the link to confirm the address. The app will open back up to your home screen once verified — you can also sign in with your email and password straight away.
The interstitial while we wait for you to tap the verification link.
Tip
Check spam if the verification email doesn't arrive within a couple of minutes. It comes from a @mangybyte.com sender.
Sign in
Tap Sign in on the welcome screen and enter your email and password. Sessions refresh silently in the background, so once you're in you stay in.
Email + password. Forgot-password link opens a reset flow by email.
If you see a "session expired" message, just sign in again — your data is safe and your club memberships are preserved.
Your first home screen
When you first sign in without being in any club, the home screen prompts you to either join an existing club or create a new one. You can do both from the profile button in the top-right.
Before any club is joined or created, the home screen offers both options up front.
Join a club
If a friend or admin has sent you an invite link, tap it on your phone — it opens the app (or takes you to the store to install it first), and the club is added automatically after you sign up or sign in. No code required.
To join manually, tap Join a club from the home screen or profile, then paste the invite code your club's admin has shared.
Paste the code or tap the emailed link — same result either way.
Start a new club
From your profile tap Create club. You'll pick a club name, a default sport (tennis, padel, squash, table tennis or badminton), and an accent colour. The accent colour tints the whole app for you and your members, so pick something you like — it's easy to change later.
Name, sport, accent. The first person to create a club becomes its super-admin automatically.
Super-admin
Creating a club makes you its super-admin. You can add other admins later from the Members screen.
Home & navigation
The home screen
Once you're in at least one club, the home screen becomes your dashboard. Each club appears as its own card, with the club name, accent colour, and a horizontal carousel of that club's leagues. Tap any league to jump into its detail screen.
A populated home screen — clubs, leagues, and any pending prompts at the top.
The top of the home screen is reserved for prompts — things that need your attention, like a result someone else recorded against you that needs confirming, or a match proposal waiting for your response.
Multiple clubs
You can be in as many clubs as you like. Each club is independent — different sports, different members, different accent colours. The home screen stacks them vertically, newest at the top. Tap the profile avatar in the top-right to switch account settings or jump between clubs.
Two or more clubs? Each gets its own card and accent.
Pending prompts
When someone records a result against you, or proposes a match time, or an admin needs you to confirm something — it appears at the top of home as a clear call-to-action card. Tap the card to action it.
"Confirm result" banner — tap to open the confirmation sheet.
Admin
Admins see extra prompts too: "Round ended — progress boxes" appears when a round is complete and needs to be progressed.
Admin-only surface when a round is ready to progress.
Playing leagues
League detail & boxes
Tap a league from the home screen to open its detail view. At the top you'll see the league's name, the current round number, and a progress bar showing how many matches in the round are complete. Below that are the boxes — each box is a small group of players who play each other in the round.
League overview — round progress and the list of boxes.
Your own box is always highlighted. Tap any box to open its standings and match grid.
Box standings
Each box's standings show player, wins, losses, sets/games won-lost, and points. The bands at the top and bottom of the box indicate promotion and relegation — the coloured bars show who's moving up and down when the round closes.
Standings within a box. Top band promotes, bottom band relegates.
Tap the Matches tab to see the match grid — every pairing in the box with either a result or a "not played yet" chip. Tabs let you filter to all matches, your matches, or just the ones pending your action.
Match grid with filter tabs. Handy for finding your outstanding games.
Record a match result
After you've played a match, tap Record result on the league detail screen (or on your matches tab). Pick your opponent from the box, enter the score set by set, and submit.
Record result — pick opponent, enter scores. Works for all supported scoring systems.
Open the league and tap Record result.
Select your opponent from the list.
Enter each set's score. The app validates as you go (for example, a tennis set can't end 7-5 if you only won 5 games).
Add an optional comment — useful if the match was a walkover or retirement.
Tap Submit. Your opponent gets a notification to confirm.
Scoring
Squash clubs can choose PAR-11 or PAR-15 scoring per club — the record-result sheet adapts automatically. Tennis tie-break rules follow the club's sport config.
Confirm an opponent's result
If your opponent recorded the match first, you'll see a Confirm result banner at the top of home. Tap it to open the confirmation sheet — you'll see the scores they entered and can either approve, decline, or dispute.
Confirm or dispute. Approved results immediately count towards standings.
If you dispute, your club's admin is notified and can step in to resolve it.
Propose a match time
Not sure when to play? Use Propose match on the matches tab to suggest a date, time, and venue. Your opponent gets a notification and can accept, decline, or counter-propose.
Pick a time, add a venue, send. The match stays in proposal state until both agree.
Doubles matches
Doubles leagues work the same way as singles, except each match is recorded against a pair rather than an individual. Pairs are set up by the admin when the league is launched. The record-result sheet shows both players on each side.
Doubles — two players per side, same scoring logic.
If your doubles partner needs to change mid-season, all three affected players (you, your old partner, and the new partner) have to agree. The app handles the three-way consent automatically — nobody can change partners unilaterally.
Match history
Your full singles and doubles history lives on your profile. You can also tap any player in the box standings to see their history and head-to-head record against you.
Match history — every recorded result, newest first.
Profile
Profile overview
Tap your avatar in the home screen's top-right to open your profile. It shows your photo, display name, which clubs you're in, your skill level, your per-sport stats, and your sport approvals.
Profile — photo, name, stats, and sport access.
Display name & alias
Tap Edit on your profile to change your display name. Some clubs also enable aliases — a per-club nickname that shows instead of your display name in that specific club. Useful if you want "Rich" everywhere except the club where you go by "RichOB".
Edit display name, plus a per-club alias if your club allows it.
Super-admin
Aliases are per-club. If you don't want members renaming themselves in your club, turn the toggle off under Club settings → Allow aliases.
Profile picture
Tap Change profile picture to upload a photo from your camera roll. The app crops it to a square, compresses it, and uploads it. Photos go through automatic safety checks (Apple Vision on iOS, Google Vision on the server) before they're visible to other members.
Picker opens your photo library. Large images are handled automatically.
Skill level
Pick a skill level (Beginner, Intermediate, Advanced, or Expert). Admins use this when seeding boxes so you're matched with the right standard for your first round. Once you've played a few matches your actual results replace skill as the sort key.
Self-selected level. Admins can override if needed.
Requesting a sport
A club can run any mix of the five supported sports — tennis, padel, squash, table tennis, and badminton. When you join a club you're automatically opted into the default sport. To play a different one, tap Request access under Your sports and pick which. An admin reviews and approves.
Per-sport approvals let admins gate who's in which league pool.
Running a club
Club settings
Tap your club's name on the home screen, then the gear icon, to open club settings. Everything in this screen is super-admin-only — regular players and admins see a read-only view.
The club settings hub. Scrolls to reveal every control.
Super-admin only
If you're an admin (but not super-admin), most of this screen is hidden. Super-admins can promote an admin to super-admin via Member management and then transfer ownership.
Branding & accent
Under Branding you can upload a club logo and pick the accent colour that tints the UI for every member of your club. The accent appears in buttons, chips, highlights, and the glass-effect club header.
Accent picker + logo upload. Changes ripple out immediately.
Enabled sports
Toggle which of the five sports your club runs. For squash clubs, pick between PAR-11 and PAR-15 scoring — the whole club follows that scoring system.
Enable tennis, padel, squash, table tennis, or badminton — mix and match.
Allowing aliases
The Allow aliases switch decides whether members of your club can set a per-club alias on their profile. Off by default — turn it on if you want to let members use different names in different clubs.
One switch. Off for consistency, on for flexibility.
Admin tools
Admin page
Every admin action is gathered into a single Admin page, accessed from the club settings screen or the profile menu. It groups actions by area: members, results, photos, welcome packs, and ownership.
One screen, all the admin tools. No digging.
Member management
The Members screen lists everyone in your club, with role badges (player / admin / super-admin) and a search bar. Tap any member to open their detail sheet — you can change their role, enable or disable sports for them, or archive them (which hides them from leagues without deleting their history).
Want an admin who doesn't play? Toggle their Plays in leagues flag off. They'll still have admin powers but won't appear in league pools, box seeding, or opponent pickers.
Inviting by email
Use Invite members on the admin page to send a join link by email. Paste in any number of addresses — the app sends each one a one-off invite that auto-adds them to your club when they sign up.
Email invites. Links auto-join the inviter's club when accepted.
Overriding a result
If two players can't agree on a result, any admin can override it. Open the match from the matches tab and tap Admin override — you can enter the correct score or mark the match as a walkover, retirement, or draw.
Admin override replaces the disputed result; both players get notified.
Photo moderation
New profile photos are automatically scanned (Apple Vision + server-side SafeSearch). Anything flagged appears in the moderation queue for an admin to approve or reject. Approved photos become visible to other members instantly; rejected ones never go live.
Moderation queue with the Vision flags for each photo.
Welcome pack PDFs
Generate a printable welcome pack — club logo, contact info, league schedule, member roster, court rules — as a single PDF. Share it with new members or post it on your noticeboard.
One-tap PDF pack. Branded with your club's logo and accent.
League lifecycle
Create a league
From the club home screen tap Create league. Pick the sport, the format (box league or ladder), the box size (typically 4–6 players), how many boxes, and the round length.
League config — sport, format, boxes, round length.
Launch a league
After you create the league, seed the boxes — the app suggests seedings based on members' skill levels and historical standings. Review, adjust by drag-and-drop, and tap Launch. The league goes live and members can record matches straight away.
Launch sheet — confirm seeding, go live.
Round progression
When a round completes (or its deadline passes), the admin progresses it. The app shows a preview of every promotion and relegation, applies them, and sets up the next round's boxes. Players can see the updated boxes immediately.
Preview before applying. No surprises.
End a league
When the season's over, tap End league from the league settings. The league archives, standings freeze, and winners are locked in. A completed league can still be viewed for history but no further results can be recorded.
Closing a league archives it. Safe — nothing is deleted.
Past leagues
Completed leagues appear under Past leagues on the club card. Tap to view the final standings and match history. Useful for settling arguments about who won the 2025 summer season.
Archive of completed seasons, read-only.
Settings & help
Account & privacy
From your profile tap Account to change your email, reset your password, or delete your account. Account deletion removes your personal data within 30 days — match history remains in your club's archive but is anonymised so nobody can identify you.
About page — privacy, terms, support links, version info.
See the Privacy Policy for full details on what data is stored and how long.
Troubleshooting
Most common issues are covered on the Support page. A quick list:
Signed out unexpectedly — sign back in, your data is fine. Sessions refresh silently when they work.
Can't upload a photo — check the app has photo library permission in iOS/Android system settings.
Wrong score recorded against you — decline the confirm, ask your opponent to re-submit. If there's a real dispute, contact an admin.
Sideloaded Android APK blocked by Play Protect — tap "Install anyway" on first install. Updates pass through the browser and don't re-trigger the warning.
