Netball Scorer Pro

Welcome to Netball Scorer Pro! Here's how to get started:

Step 1 - Set Up Your Game:
From the home page, click the "⚙️ Setup" button. Enter:

• Team 1 and Team 2 names (or select from suggestions)
• Quarter length (usually 15 minutes)
• Venue/Location (optional)
• Game date and time (optional)
• Which team gets the first center pass

Step 2 - Start the Game:
Click "🚀 Start Game" to begin. You'll see the game screen with the timer and score controls.

Step 3 - Record Scores and Time:
Use the + buttons to add goals for each team, and - buttons to undo. Click "▶️ Start" to begin the quarter timer.

Step 4 - Manage Quarters:
When a quarter ends, click "⏭️ Next Quarter" to move to the next quarter. The timer resets and the center pass updates automatically.

Optional Features:

• 📄 Scorecard: View or print a formal scorecard from the Stats page
• 📊 Stats: View game statistics and quarter breakdowns
• 💾 Save Game: Save your game to view later in the "📚 Games" section

Netball Scorer Pro is designed for anyone involved in netball games:

Scorekeepers & Timekeepers: Official game scoring with automated center pass tracking, quarter timers, and professional scorecards. Perfect for league games, tournaments, and competitions.

Coaches & Team Managers: Track training games, analyze quarter-by-quarter performance, and maintain game records. Save and review past games for team development.

Referees & Umpires: Keep accurate time and score during matches. The app handles the complex center pass rules automatically, supporting both Simple and Official INF rule variations.

Parents & Volunteers: Easy-to-use interface for community games, school matches, and junior netball. No technical knowledge required - works offline after installation.

All Levels Welcome: From grassroots community netball to competitive league games. Configurable quarter lengths support all age groups and competition formats.

Scoring: Each goal scores 1 point and must be shot from inside the goal circle by either the Goal Shooter (GS) or Goal Attack (GA).

Team Size: Teams have up to 12 players but only 7 on court at any time. Players must stay in their designated zones based on their position.

Ball Handling: Players cannot travel with the ball (no running while holding it). You cannot hold the ball for more than 3 seconds.

Defending: Defending players must stand at least 3 feet (0.9m) away from the ball holder. You cannot snatch or hit the ball from an opponent's hands.

Throw-ins: When the ball goes out of bounds, you have 3 seconds to return it to play from the sideline.

Standard Games: 4 quarters of 15 minutes each (60 minutes total play time).

Breaks: There are 2-minute breaks between Q1-Q2 and Q3-Q4, and a 5-minute half-time break between Q2-Q3.

Junior Games: Often use 10-12 minute quarters depending on age group and competition level.

Umpires (2): Control the game and make rule decisions. Each umpire is responsible for one half of the court.

Scorekeepers (2): Record scores and maintain official records throughout the game.

Timekeepers (2): Monitor game time, quarter lengths, and break periods.

Game Start: The team winning the coin toss gets the first center pass and is designated "evens"; the other team is "odds".

After Each Goal (During Play): Add both team scores together. If the total is even, the "evens" team takes the center pass. If odd, the "odds" team takes it.

At Quarter Breaks: This app supports two rule variations you can choose during game setup:

Simple Rules (Recommended): The evens/odds designations always swap at quarter breaks. This is easier to use and suitable for most recreational games. No questions asked - just click "Next Quarter" and continue playing.

Official INF Rules: Uses the official "If in play, change the way" rule. When you click "Next Quarter", the app will ask: "Did the quarter end on a goal?" If YES (goal just scored), designations stay the same. If NO (ball was in play), designations swap. This follows full International Netball Federation rules but requires answering a question each quarter.

Note: In both cases, after the designations are determined, the app calculates which team gets the center pass based on whether the total score is even or odd.

Quick Start (4 Steps)

1. Setup Game: Click "⚙️ Setup" and enter team names, venue, date/time, and quarter length (usually 15 minutes)
2. Start Game: Click "🚀 Start Game" to begin scoring
3. Record Scores: Use + buttons to add goals, - buttons to undo. The app automatically tracks quarter scores and center pass
4. Manage Timer: Click "▶️ Start" to begin the quarter timer, "⏸️ Pause" to pause it. After each quarter, click "⏭️ Next Quarter" to advance

Detailed Features

Timer: Displays remaining time for the current quarter or break. Click "🔄 Reset Quarter" to restart the timer if you made a mistake.

Score Buttons: Use the + (add goal) and − (undo goal) buttons for each team. Large score display shows current quarter score.

Center Pass: The app automatically calculates which team has the center pass based on the total score and the rules you selected during setup.

Scorecard: Go to the Stats page (📊) and click "📄 View Scorecard" to see a printable summary of all quarter scores, totals, and game details.

Stats: Click "📊 Stats" to view game statistics including quarter-by-quarter breakdowns and leading team.

Save Games: Click "💾 Save" during or after a game to save it. Load saved games from "📚 Games" to review past matches.

Adding Awards: Go to the Stats page (📊) after the game has ended. Scroll down to the "🏅 Player Awards" section. Select an award category and enter the player's name, then click "Add Award". Note: The awards section is locked during active games and only becomes available once you end the game.

Award Categories: Choose from suggested categories like Player of the Match, Best Defender, Best Attacker, Coach's Player, Players' Player, Most Improved, and more. You can also type your own custom category.

Managing Awards: Awards are saved automatically. You can add multiple awards and delete any by clicking the ✕ button next to each one.

Privacy: Awards appear on your local scorecard and when you print it. However, player names and awards are never included in shared game links to protect player privacy.

No cookies are used. This app does not use cookies and does not track you across websites.

Privacy-Focused Analytics: We use Umami, a privacy-focused, cookie-free analytics tool, to understand how the app is used (e.g. which screens are visited and how often games are played). Umami does not collect any personally identifiable information, does not use cookies, and does not track you across websites. All data is anonymised and aggregated. No individual user can be identified. Umami is GDPR-compliant and respects your privacy by design.

Local Storage Only: All your game data (team names, scores, saved games) is stored locally in your browser using localStorage. This data never leaves your device and is only accessible to you.

Offline Functionality: The app uses a Service Worker to enable offline access. This caches the app files on your device so you can use it without an internet connection.

Your Privacy: Game data is stored locally on your device. You have complete control over your data and can clear it anytime through your browser settings or by using the "Clear All Games" button in the Saved Games screen. If optional account features are introduced, any data collection will be clearly explained at that time.

Sharing creates a link with game data encoded in it. When you share a game, the following information is included in the shareable link:

• Team names and scores (including quarter-by-quarter breakdown)
• Current quarter and time remaining
• Game date, time, and venue
• Center pass settings (which team is evens/odds)

Player Awards: Player names and awards are never included in shared links to protect privacy. Awards only appear on your local scorecard and are not transmitted when you share a game link.

Who can access it? Anyone with the link or QR code can view the game data. The link does not expire and can be shared further by recipients. There is no way to revoke access once a link has been shared.

No server storage: Your game data is encoded directly in the URL itself. Nothing is uploaded to any server. This means shared links work offline and there is no account or login required.

Link length: Because all data is in the URL, links can be quite long (1000-2000 characters). Most messaging apps handle this, but some older systems may truncate long links. The QR code option is more reliable for sharing.

What is it? The Live Scoreboard opens a large, read-only display in a new browser tab. It's designed to be shown on a TV or monitor so spectators can follow the score in real time.

How to launch: Click the "📺 Scoreboard" button on the Home screen or the Game screen. A new tab will open with the scoreboard display.

How it works: The scoreboard updates automatically whenever you change the score, start the timer, or advance the quarter in the game tab. Both tabs must be open in the same browser on the same device.

Important: The Live Scoreboard is only available when using the app in a web browser. It is not available in the installed (home screen) version of the app, as installed apps cannot open new browser tabs.

Note: The scoreboard uses your browser's BroadcastChannel API to receive updates. If your browser does not support this feature, a message will be displayed. All modern browsers (Chrome, Firefox, Edge, Safari) support it.

Netball Scorer Pro uses the following open source software:

• qrcode-generator by Kazuhiko Arase
  QR code generation for game sharing
  MIT License • GitHub

Thank you to all the open source contributors who make projects like this possible.