User Guide

This site has two layers. The public layer is open to anyone with the link — roster, schedule, live scores, full box scores, standings, brackets, and season stats. The admin layer is the editor: roster updates, schedule entry, live scoring, and box score editing. Anything that changes data lives in the admin layer.

• Home — hero banner, next game, top stat highlights.
• Roster — every player with jersey, position, grade, height, photo.
• Schedule — every game in the current tournament with status (Upcoming · Live · Final) and final score.
• Standings — W-L records computed automatically from final scores.
• Brackets — tournament bracket view.
• Stats — season totals and averages per player. Click a player to see per-game splits.
• Tournament — current tournament info (venue, dates, division, external link).

Live status on the schedule

On Schedule, every game card shows one of three badges: Upcoming, ● Live, or W/L (with the final score). Live games update in real time — no refresh needed.

Tap "Box score" for the full picture

Each game card has a Box score button that opens that game's dedicated page. It shows the opponent, date, court, current score, status, and a per-player box score (points, rebounds, assists). The page subscribes to live updates, so when a coach is running the live scorekeeper on game night, the numbers tick up automatically.

Sharing

Each game has its own URL of the form /games/<id>. Share that link and anyone — logged in or not — can watch live and see the box score.

Stats rolls up every box score for the season. Tap a player name to drill into a per-game breakdown. Numbers update automatically as box scores are edited or live events are recorded.

There are three roles:

• Public viewer — no account needed. Can see everything described above.
• Pending — signed up via the invite link, awaiting admin approval. Sees an "Awaiting approval" screen.
• Admin — approved by another admin. Can edit roster, schedule, opponents, tournaments, box scores, and run live scoring.

To request access, ask an admin for the invite link from Admin → Users. Sign up, then wait for approval. The first user who ever signs up becomes admin automatically.

Signed-in admins see an Admin tab in the top nav. Inside:

• Players — add or edit the roster (name, jersey, position, height, grade, photo).
• Games & Scores — create games, set opponent + court + date, enter final scores.
• Opponents — manage the list of teams in your division. Mark which one is "us".
• Tournaments — create tournaments and mark the current one (drives Schedule, Standings, etc.).
• Users — copy the invite link, approve pending signups, promote/demote admins.

Live scoring

From any game's admin page, tap Live scoring. The keeper is built for one operator on a phone: tap a player, then tap +1 FT, +2 FG, or +3 PT. The team score and the player's box score update in one tap. +1/+2/+3 OPP credits the opponent. Undo reverses the last action.

The game clock runs in the operator's browser and is saved per-game in local storage. If the tab is closed mid-game, the clock pauses until reopened.

Reset game

Each game's admin page has a Reset game button. It deletes all live scoring events and box-score rows for that game and sets the score back to 0–0. Use it if you started a test game by mistake. This cannot be undone.

• Public read: roster, schedule, game pages with box scores, live scores, standings, brackets, season stats, tournament info.
• Admin only: editing the roster, creating/editing games, entering box scores, running live scoring, resetting games, managing users.

Do fans need an account to watch a live game?

No. The schedule, game pages, and box scores are public.

I signed up but can't access Admin.

New signups land in Pending. An existing admin has to approve you from Admin → Users.

Can I edit someone else's box score?

Only admins can edit. Public viewers always see read-only numbers.

Live score isn't updating.

Check your internet connection. The page subscribes to real-time updates; if the connection drops, refresh once.