Tournaments

League event, member-guest, charity scramble, your normal monthly gathering of 12 — Tournaments collapse 90 minutes of spreadsheet work into 90 seconds of tapping. Build the field, group into foursomes, optional Calcutta auction, share-link invites. One combined ledger across the tournament prize, the Calcutta, the foursome bets, and every greenie.

Build the event

1. Tap Events tab → + top right → New tournament.
2. Name + course (favorites and recently played show first).
3. Format — typical: team-bestball-aggregate for a 2-man best-ball with team net counted hole-by-hole. Stroke-aggregate, stableford, and match-bracket are also supported.
4. Add players — type a name + handicap index per row. The app auto-computes course handicap from the slope/rating of the tee box you picked.
5. Group into foursomes — auto-foursomes by handicap (high + low + mid + mid) is the default; drag rows around if you want to override.
6. Optional Calcutta auction — toggle on, type each team’s owner + winning bid. Pick payout split (50/30/20, 60/30/10, custom).
7. Save. The tournament + all its rounds + entries + Calcutta config are created in a single atomic POST — no half-finished events.

Sharing the event

Tap Share on the tournament page. You get a deep link like:

heycaddy://tournament/<id>

AirDrop or text it. Recipients tap → app opens to the event → picks their name from the player roster → starts scoring on their own phone. No friend invites, no separate auth — the link IS the invite.

During the round

• Live leaderboards. Tap the tournament → see individual net leaderboard + team-bestball leaderboard, both updating as scores roll in across all 3 foursomes.
• Foursome cards. Each foursome has its own card. Tap one → see the four players + each one’s thru / score-to-par / open round.
• Greenies on par 3s. The greenie prompt fires automatically when anyone in the foursome scores a par 3. Tap closest-to-pin (or skip).
• Per-foursome side bets. Each foursome can run its own Nassau / Hi-Lo / Skins on top of the tournament. They’re scoped to that foursome — no leakage.
• Tournament cuts & ties. The leaderboard handles ties, ordinal positions, and pace-of-play "thru N" naturally.

Calcutta settlement

When all 18 are in (every player in every foursome has a hole-18 score), the Calcutta settle button activates. Tap it.

1. The team leaderboard finalizes (1st, 2nd, 3rd by team-bestball aggregate).
2. The pot is split per your saved payout structure (e.g., 50/30/20 of total auction proceeds).
3. Each owner’s payout vs their bid is shown — net win or net loss per owner.
4. Final ledger: combined view across tournament prize → Calcutta payouts → foursome side bets → all greenies. Every dollar accounted for in one screen.

Calcutta keys are free-text strings (team labels + owner names you typed at create time). The settle ledger displays them as-is when no roundPlayer UUID match exists, so even guest owners (someone’s wife who doesn’t use the app) get rendered correctly.

Format reference

• stroke-aggregate — sum of best 1-ball net per team or net total per individual.
• stableford-aggregate — points by hole per scoring scale, summed.
• team-bestball-aggregate — sum of (best net of team A players) − par per hole. Default for 2-man best-ball.
• match-bracket — knockout bracket; pair of players (or teams) per match.
• scramble — single team score per hole, posts as the team's "round."