LeaguesScoring Guide

Scoring Guide

End-to-end scoring workflow from setup and venues to ball-by-ball scoring

Scoring Flow

Pre-Match ChecksSet Toss & Playing XIScore BallsInnings BreakMatch Complete

League SCORER — assigned by league admins to score any match in the league.
League ADMIN / OWNER — full management access includes scoring.
Club CAPTAIN / SCORER — can score matches where their club's team is playing.
Global ADMIN — site administrators can score any match.
If you don't see the "Start Scoring" button on a match page, you don't have permission. Ask a league admin to assign you the SCORER role.

League profile: verify league details and season settings are finalized.
Club profile: ensure participating clubs and teams are approved in the league.
Player profile: confirm players are on correct team rosters and available for Playing XI.
Venue: verify the fixture venue is configured in /leagues/{leagueId}/venues with address/map details.
Roles: confirm scorer access before match start to avoid last-minute delays.

1. Navigate to the match detail page (League → Tournament → Match).
2. Confirm league setup is ready: clubs approved, teams registered, and fixture created.
3. Expand "Match Settings" to set toss winner and toss decision (BAT or BOWL).
4. Set overs if different from tournament defaults and confirm the assigned venue.
5. Expand "Playing XI" to select players from each team roster and save.
Tip: keep player and club profiles updated (/profile and /clubs) so selection and identity are accurate on match day.

The scoring interface shows the current score, batsmen, and bowler at the top.
Tap run buttons (0, 1, 2, 3, 4, 6) to record runs off each delivery.
For BOUNDARIES: 4s are highlighted in blue, 6s in purple.
For WIDE: Tap the "Wide" button — adds 1 extra run and the ball doesn't count.
For NO BALL: Tap "No Ball" — adds 1 run penalty. Next ball is a free hit.
For BYE / LEG BYE: Use the "EXTRAS" menu for byes and leg byes.
For WICKET: Tap the red "WICKET" button and select the dismissal type (Bowled, Caught, LBW, Run Out, Stumped, Hit Wicket).
After a wicket, you'll be prompted to select the new batsman from the Playing XI.

After 6 legal deliveries, the "End Over" button becomes active.
Tap "End Over" to complete the over — the strike rotates automatically.
You'll be prompted to select the new bowler for the next over.
The same bowler cannot bowl consecutive overs (cricket rules).
The current over display shows each ball as a circle: dots (•), runs, or wickets (W).

The first innings ends when: all 10 wickets fall (ALL OUT), all overs are bowled, or you manually end it.
After the 1st innings, you'll see the summary and target runs.
Click "Start 2nd Innings" to set up the chasing team's innings.
Select the opening batsmen for the chasing team and the opening bowler.
The target is displayed throughout the 2nd innings.

The scoring interface works offline! Balls are stored locally on your device.
The sync status indicator shows: ✓ Synced (green), ↻ Syncing (yellow), ⊘ Offline (orange), ✕ Error (red).
When connectivity returns, queued balls are automatically synced to the server.
Important: Don't close the browser tab while offline — pending balls are stored in local storage.
If sync errors occur, try refreshing the page. Pending balls will be re-synced.

Made a mistake? Tap the "Undo" button to remove the last ball of the current over.
Undo removes the ball from both local state and the server.
You can only undo balls within the current over. Once an over is ended, you cannot undo it.
Undo also reverses all stat updates (batsman runs, bowler figures, extras, wickets).