League Help Guide

A League is an independent cricket organization that hosts tournaments. Unlike clubs, leagues are not owned by any single club — they are standalone entities with their own admin hierarchy. Think of it like a real-world cricket association (e.g. "City Cricket Association" or "Corporate Cricket League").

• Leagues are independent — any registered user can create one.
• Leagues contain Tournaments (e.g. "Summer T20 2026", "Winter Cup").
• Clubs register to join a league. Teams from approved clubs register for specific tournaments.
• League admins manage club approvals, tournament creation, fixtures, and standings.

Leagues come in four types to suit different contexts:

• Open — Anyone can register their club. Public visibility.
• Invite Only — Clubs need an invitation or approval from league admins to join.
• Corporate — Designed for inter-company cricket leagues within organizations.
• School — Built for school-level cricket with age-appropriate settings.

Any logged-in user can create a league and become its owner.

1. 1Open /leagues/create (or go to Leagues and click "Create League").
2. 2Fill in the league details: name, description, type, city, country, and optional website.
3. 3The slug (URL-friendly name) is auto-generated from the name and can be edited.
4. 4After creating, you are redirected to /leagues/{leagueId} as the Owner.

Profiles are now first-class and should be set up before tournament operations.

1. 1Player profile: open /profile to complete cricket role, batting style, bowling style, DOB, bio, and photo.
2. 2Club profile: open /clubs, create a club, then manage details on the club page (/clubs/{clubId}).
3. 3League profile: open your league page (/leagues/{leagueId}) and keep description, location, and branding updated.
4. 4Use complete profiles to improve registrations, discoverability, and match-day administration.

League members have specific roles that control what they can do:

• Owner — Full control. Can manage all settings, members, clubs, and tournaments. Can delete the league.
• Admin — Same as Owner except cannot delete the league or remove the Owner.
• Tournament Director — Can create and manage tournaments, generate fixtures, and manage teams.
• Scorer — Can score matches within the league's tournaments.
• Umpire — Designated match official role (for future umpire features).
• Member — Basic membership with read access to league internals.

Club owners/admins can register their club to participate in a league.

1. 1Browse to a league's dashboard page.
2. 2Click "Register Club" and select which of your clubs to register.
3. 3Your registration starts with a "Pending" status.
4. 4A league admin will review and approve or reject your registration.
5. 5Once approved, your club's teams can register for tournaments in that league.

Players can request to join any active club without waiting for an email invitation.

1. 1Open the club's page (e.g. /clubs/{clubId}).
2. 2Click "Request to join" — you'll see "Request pending approval" until an admin acts on it.
3. 3Club owners/admins see your request in a "Pending join requests" card on the Members page with Approve / Reject buttons.
4. 4Once approved your status flips to ACTIVE — you become a Member of the club and the club shows up under "My Clubs & Teams" in your top-right user menu.
5. 5Admins can still send direct email invites for specific roles (Captain, Scorer, etc.) from the same Members page.

Spin up a new team and its starting roster in one step instead of three nested screens.

1. 1On your club page, open the Teams tab and click "Create Team".
2. 2Fill in the team name (slug auto-generates) and an optional description.
3. 3Below that, you get 11 prefilled roster rows. Each row toggles between New (type a name + role inline) and Existing (search the player database).
4. 4Submit once — the team is created and every filled row is added to the squad sequentially.
5. 5If a single row fails (duplicate, validation), the rest still save and you land on the team page with a warning so you can fix individual entries.
6. 6Add or remove rows freely with the "Add row" / trash icons before submitting.

When you are signed in, the Leagues page shows a "Your cricket" band with one-click shortcuts.

• My Clubs — jumps directly to your primary club's dashboard (or /clubs if you have none).
• Quick Create — opens the club's Matches tab with the new-match form preselected, so you skip navigating through Tournament → Fixtures.
• Live · Resume — when a match you can score is IN_PROGRESS, this card jumps straight into the scoring UI; otherwise it shows the next upcoming match for you.
• The band auto-hides for users with no clubs and no scoring matches, so newcomers see the public leagues grid only.
• Same shortcuts are reachable any time from "My Clubs & Teams" in the top-right user menu (separate from "My Fantasy Teams").

Tournaments are competitions within a league. Each tournament has its own format, rules, schedule, and standings.

• Formats: Round Robin (each team plays every other once), Double Round Robin (home and away), Knockout (seeded bracket with byes), and Group + Knockout (group round robin then knockout for qualifiers).
• Match formats: T20, ODI, and Test — each tournament can specify its default format, and bilateral series can mix formats.
• Each tournament has configurable rules: overs per innings, max overs per bowler, powerplay overs, DRS, squad size limits, and points system (including separate draw points).
• Tournament statuses progress: Draft → Registration → Active → Completed.
• Teams from approved clubs register for specific tournaments.

League Owners, Admins, and Tournament Directors can create tournaments.

1. 1Go to your league dashboard and click "Create Tournament".
2. 2Set the tournament name, format, dates, and registration deadline.
3. 3Configure match rules: overs per innings, max overs per bowler, powerplay overs, DRS.
4. 4Set squad limits: minimum and maximum players per team.
5. 5Define the points system: points for win, tie, no result, and loss.
6. 6The tournament starts in Draft status. Change to Registration when ready for teams to sign up.

Club admins can register their teams for tournaments within leagues their club has joined.

1. 1Navigate to the tournament dashboard.
2. 2Go to the "Teams" tab and click "Register Team".
3. 3Select a team from your club.
4. 4Your club must be approved in the league first.
5. 5The tournament must be in Registration status and the deadline must not have passed.
6. 6Teams are subject to the max teams limit set by the tournament.

League admins can auto-generate fixtures or create matches manually.

1. 1Go to the tournament's "Fixtures" tab.
2. 2Click "Generate Fixtures" to auto-create matches based on the tournament format.
3. 3For Round Robin: every team plays every other team once.
4. 4For Knockout: seeded bracket with byes for non-power-of-2 team counts.
5. 5For Group + Knockout: group-stage round robin followed by knockout for qualifiers.
6. 6You can also add individual matches manually with "Add Match".

Leagues can maintain their own venue catalog for cleaner fixture planning.

1. 1Open /leagues/{leagueId}/venues and click "Add Venue".
2. 2Store address, map coordinates, capacity, facilities, and an optional venue image.
3. 3Edit or archive venue details as grounds change through the season.
4. 4Attach the right venues while scheduling matches so scorers and teams have consistent location data.

Standings are automatically calculated when matches are completed.

• Points are awarded based on the tournament's points system (default: 2 for win, 1 for tie, 1 for no result, 0 for loss).
• Draw support: Draws (distinct from ties) can have separate point values — useful for Test cricket where draws are common.
• Net Run Rate (NRR) is used as the tiebreaker when teams are on equal points.
• NRR = (Runs scored / Overs faced) - (Runs conceded / Overs bowled).
• Form tracker: Each team's last 5 results are tracked (W/L/T/D/NR) for quick form reference.
• For Group + Knockout tournaments, standings are shown per group.
• Standings update automatically after each match is marked as completed — all updates happen in a single batch transaction.
• Admins can manually trigger a standings recalculation if needed.

Import completed match scorecards from Excel spreadsheets or images instead of ball-by-ball entry.

1. 1Open a match page and click "Import Scorecard" (available to scorers and admins).
2. 2Download the pre-filled Excel template — it auto-populates with player names from both teams.
3. 3Fill in batting, bowling, and extras data in the spreadsheet. Alternatively, upload a photo of a paper scorecard for OCR processing.
4. 4The system validates your data: max 11 batters/bowlers per innings, run totals consistency, overs format, and wicket attribution.
5. 5Player names are matched intelligently — exact match first, then last-name fuzzy matching. Ambiguous matches are flagged as warnings.
6. 6After import, match results (winner, margin, ties, draws) are auto-calculated and tournament standings are updated immediately.

• Supports up to 4 innings for Test matches (2 innings per team).
• All wicket types supported: Bowled, Caught, LBW, Run Out, Stumped, Hit Wicket, and more.
• Extras tracked separately: Wides, No-balls, Byes, Leg-byes, Penalties.
• Re-import mode: update an existing scorecard by importing again (old data is replaced).

Rain-affected matches use the DLS method to calculate revised targets.

• Standard Edition DLS with official resource percentage tables.
• Handles single interruptions (e.g. rain stops play, overs reduced) and multiple interruptions.
• Resources are calculated based on overs remaining and wickets in hand.
• If the chasing team has fewer resources, the target is scaled down proportionally.
• If the chasing team has more resources (e.g. batting first was interrupted), extra runs are added based on the resource advantage.
• Default G50 (average 50-over score) is 245, customizable per tournament.
• Fractional overs are supported with linear interpolation for precise calculations.

Organize multi-match, multi-format series between two teams — just like international bilateral tours.

• A series can mix formats: e.g. 2 ODIs followed by 2 Tests in a single tournament.
• Each match within the series can have its own format (T20, ODI, or Test).
• Standings aggregate results across all formats — wins, losses, draws, and points are tallied together.
• Test match logic: 4 innings with target calculated on the 4th innings. Draws are recognized when the target is not reached.
• Series types: International, League, Domestic, Women's.

Score matches even without internet — data syncs automatically when you're back online.

• Ball events are stored locally in the browser using Zustand persistence middleware.
• A pending queue accumulates scoring actions while offline.
• When connectivity returns, queued events sync to the server via API and broadcast through Pusher channels.
• Status indicators show whether you're online, offline, or syncing.
• Undo works offline too — reversed events are queued alongside new ones.
• Ideal for grounds with patchy Wi-Fi — no data is lost.

Every league has automatic player rankings computed from match data across all tournaments.

• Rankings are available at /leagues/{leagueId}/rankings with three tabs: Batsmen, Bowlers, and Overall Player Rankings.
• Batting points: 1 per run, +1 per four, +2 per six, +20 per fifty, +50 per hundred, +5 per not-out, plus average × 2 and strike rate × 0.5 bonuses.
• Bowling points: 25 per wicket, 5 per maiden, 0.5 per dot ball, +50 for a 4-wicket haul, +100 for a 5-wicket haul, plus economy and average bonuses.
• Fielding points: 10 per catch, 15 per run-out, 15 per stumping, 20 per direct hit.
• Overall rankings combine batting + bowling + fielding points into a single total.
• Top 3 players in each category are shown as highlight cards with detailed stats.
• Rankings update automatically as matches are completed — no manual action needed.

The Cricketer offers four plans: Free, Pro, Premium, and Enterprise — with localized pricing for 28+ cricket-playing nations.

• Free plan: 10 matches/month, 2 tournaments, 5 teams, basic score graphics, 100 MB gallery. No credit card required.
• Pro plan: 50 matches/month, 10 tournaments, full score graphics, scoreboard display, basic academy management, ad-free, 5 GB gallery.
• Premium plan: Unlimited matches and tournaments, custom domain, full academy management, live streaming OBS overlay, white label, API access, 50 GB gallery.
• Enterprise plan: Everything in Premium plus governing body dashboard, unlimited storage, dedicated account manager, SLA guarantee.
• Per-match and per-tournament passes: Pay only for what you need without a monthly subscription.
• Prices adjust automatically based on your country's purchasing power (PPP) — visit /pricing to see your localized rates.
• Subscriptions are managed via Stripe. Upgrade, downgrade, or cancel at any time from your club dashboard.

Upload and share match photos, team images, and event documentation.

• Each plan includes a storage quota: 100 MB (Free), 5 GB (Pro), 50 GB (Premium), Unlimited (Enterprise).
• Photos can be tagged by club, league, match, or tournament for easy filtering.
• Supports photos, video thumbnails, and documents (PDF, etc.).
• Public/private visibility toggle — control what guests can see.
• Image dimensions and file sizes are tracked for responsive display.

Engage with the cricket community through comments and follows.

• Threaded comments on matches, articles, and news — reply to other comments for discussions.
• Follow clubs, leagues, players, and teams to stay updated on their activity.
• Soft-delete for comments — admins can moderate without losing thread context.
• Available on all plans including Free.

Comprehensive match rules system that covers all aspects of match management.

• Configure overs per innings, max overs per bowler, powerplay overs, and DRS availability.
• Set toss rules: which captain tosses, coin side selection, and decision recording.
• Playing XI submission: captains submit their XI before the match; scorers can override if needed.
• Umpire assignment: designate on-field umpires, third umpire, and match referee per match.
• Super Over rules for tied matches: configurable player limits and bowling restrictions.
• Wide and no-ball penalty configurations (runs awarded, free hit rules).
• Rain rules: choose between DLS, VJD, or simple run-rate methods.
• Match start time, interval durations, and close-of-play times are all configurable.
• Rules can be set at league level (apply to all tournaments) or per-tournament override.

Professional broadcast-quality overlays for live streaming your matches on YouTube, Facebook, or Twitch.

• Real-time scoreboard overlay that updates automatically from ball-by-ball scoring.
• Supports OBS Studio, Streamlabs, and any browser-source compatible streaming software.
• Add the overlay URL as a Browser Source in OBS — it connects via WebSocket for live updates.
• Customizable themes: choose colors, layout, and transparency to match your stream branding.
• Shows batting partnership, current bowler figures, run rate, and required rate.
• Automatic transitions for wickets, overs, and innings breaks.
• Works with both online and offline scoring — overlay syncs when connectivity resumes.
• Available on Premium plans. Configure from League Settings > Streaming.

Built-in helpdesk system for league administrators and players to manage issues and queries.

• Players and club members can raise support tickets from their dashboard.
• Tickets are categorized: Scoring Dispute, Technical Issue, Account Problem, Feature Request, Other.
• League admins see all tickets for their league and can respond with threaded messages.
• File attachments supported — upload screenshots or documents to explain issues.
• Ticket status tracking: Open, In Progress, Resolved, Closed.
• Website admins have a global view of all tickets across all leagues.
• Email notifications when ticket status changes or a new response is added.
• Priority levels: Low, Medium, High, Urgent — helps admins triage effectively.