Cricket Tournament Scorer with Live Ball-by-Ball Feed

College and corporate cricket tournaments are still scored on paper or in spreadsheet chaos: the scorer's notebook disagrees with the announced total, net run rate is computed by hand after midnight, and nobody watching from home knows the score. The scoring rules themselves are a great software problem — strike changes on odd runs and at over end, extras don't count as balls (except some), wickets reset the striker, NRR has a precise formula. This project encodes all of it in a scoring engine: ball-by-ball entry drives a live score, automatic strike rotation, bowler figures, partnership tracking, full scorecards for both innings, a Manhattan run graph, and a points table with NRR updated after every match. One undo tap fixes the inevitable mis-tap without corrupting the innings.

1. The organizer creates a tournament, registers teams with player squads, and generates the fixture list.
2. Before a match the scorer records the toss, the elected choice, and the playing elevens with batting order.
3. Each ball is entered as an event (runs, extra type, wicket type); the engine appends it to the innings log.
4. The engine replays the log to derive the live state: score, wickets, overs, striker/non-striker, bowler figures, partnerships and run rates.
5. Live views — score header, this-over strip, Manhattan graph — render from the derived state and update on every ball.
6. At innings/match end the engine finalizes scorecards, computes the result and margin, and updates the points table and NRR.
7. Scorecards and the points table can be shared or printed; the event log keeps every ball auditable.

Tech stack:

• HTML, CSS and JavaScript (touch-first scorer UI)
• Node.js with Express (tournament API)
• SQLite (tournaments, matches, ball-by-ball event log)
• WebSocket live updates to viewer screens
• Event-sourced scoring engine (replayable innings log)
• Puppeteer (printable scorecard export)
• Docker (one-command deployment)

• [Ball-by-ball entry] Big touch-friendly buttons for 0–6, wides, no-balls, byes, leg-byes and wickets, with batsman and bowler pickers per ball.
• [Automatic cricket logic] Strike rotation on odd runs and over completion, extras handling, bowler over limits, and innings break detection — the scorer never does arithmetic.
• [Live score and scorecards] Current score, required run rate in chases, full batting and bowling tables for both innings, fall of wickets.
• [Manhattan graph] Runs-per-over bar chart for each innings, with wicket overs highlighted.
• [Points table with NRR] Wins, losses, points and net run rate computed automatically from completed matches, sorted per tournament rules.
• [Tournament management] Create tournaments, register teams and players, generate fixtures, record toss and results.
• [Undo and corrections] Every ball is an event in an append-only log, so undo replays the innings correctly instead of patching numbers.

• Scoring engine source code with cricket-rules documentation
• Touch-friendly scorer UI and live viewer screens
• Tournament manager (teams, fixtures, points table)
• Database schema for tournaments, matches and ball events
• Sample tournament dataset for the viva demo
• Project report PDF (background, scoring-logic design, NRR math, methodology)
• PPT presentation for final review
• Viva Q&A preparation document (event sourcing, cricket rules encoding, NRR, offline sync)