Countdown Widget

Dates are hardcoded. The getTodayKey() function returns the current date key — outside trip dates it returns '9-30' as a fallback for tee times display.

Tee Times Widget

Shows today's rounds from TODAY_SCHEDULE keyed by date. Displays course name, Practice/Tournament badge, and both tee times (Pairing 1 / Pairing 2). Hidden when no schedule exists for today. On post-trip dates the entire widget is replaced by the Trip Summary.

Weather Widget

Fetches live data from Open-Meteo API using hardcoded coordinates for each trip day's course location. Shows current temp (°F), weather description, wind speed, humidity, and daily high/low. Falls back to "Live on trip" placeholder if fetch fails or app is in preview mode. Hidden entirely after Oct 4.

Daily MVPs Widget

Only visible during the trip (hidden after Oct 4). Shows three categories:

• Most Points — player with most individual match play points today
• Best Net — player with best net score relative to par today
• Most Drinks — player with most drinks tracked today

Shows placeholder "MVPs will appear after the first round is complete" until at least one of today's rounds is fully scored. If two rounds happen on the same day (Oct 3), it accumulates across both.

SH*T TALK THREAD (Chat)

Real-time group chat backed by Supabase messages table. Any player can send messages. Messages persist for the life of the app. The input is disabled until a player is selected. Duplicate messages are prevented via optimistic rendering — an optimistic message is pushed immediately on send, then replaced by the real Supabase record when the INSERT event arrives via WebSocket.

Post-Trip State (after Oct 4)

The tee times, weather, and MVP widgets are all hidden. The countdown area is replaced by a Trip Summary showing final team points per round and the tournament winner.

Round Pills

5 pills: FD · Loop · South · Dozen · Bluffs. Active pill highlighted navy. Tap to switch rounds. Selection persists in localStorage.

Pairing Toggle

Two buttons: Pairing 1 / Pairing 2. Each pairing is 2v2 better ball match play. Pairings per round:

• R1 Forest Dunes: P1: Ben+Bryan vs Jon+Nate · P2: Cody+Jeff vs Owen+Steve
• R2 Loop Black: P1: Ben+Cody vs Jon+Owen · P2: Bryan+Jeff vs Nate+Steve
• R3 South: P1: Ben+Jeff vs Jon+Steve · P2: Bryan+Cody vs Nate+Owen
• R4 Dozen: P1: Ben+Bryan vs Jon+Owen · P2: Cody+Jeff vs Nate+Steve
• R5 Bluffs: P1: Ben+Cody vs Jon+Nate · P2: Bryan+Jeff vs Owen+Steve

Scorecard Layout

7-column grid: Hole · Par · TBD · TBD · PTS · TBD · TBD. Column headers will show player names once teams are assigned. Navy = Team 1, Green = Team 2.

For 12-hole rounds (The Dozen), the scorecard splits into "Front Six" and "Back Six" instead of front/back nine. Subtotals show at the halfway point and at the end.

Score Entry

Tap any score cell → modal opens with − / + controls for score and drink count. Tap outside or save to confirm. Scores save to Supabase immediately and broadcast to all connected devices via WebSocket.

Score color coding:

• Eagle or better — navy circle with navy ring outline
• Birdie — light blue circle
• Par — light grey (default)
• Bogey — light salmon/pink
• Double bogey — red circle with red ring outline
• Triple+ — red diagonal stripe pattern

Fire / Heating Up

Calculated on net scores (gross minus handicap strokes on that hole).

• 3+ consecutive net pars or better = player is on fire 🔥
• Fire score cells get an orange border + flame emoji overlay
• Streak resets the moment a net bogey or worse is posted
• Works across the full round including the break between front and back nine
• The Dozen: streak can carry across the midpoint (hole 6 → hole 7)

Stroke Dots

Stroke dots appear below the score button on holes where a player receives a handicap stroke.

• 1 stroke — single filled navy dot, bottom-left corner of score button
• 2 strokes — same dot with a tight ring around it
• Shared stroke hole (all 4 players in the pairing stroke) — dot fades to 20% opacity

Current state: SUPPRESS_SHARED_STROKE_DOTS = true — all dots suppressed until course handicaps are entered. When you populate course handicaps, flip this flag to false.

Important: Course handicaps in the COURSES array must already be pre-calculated at 90% of USGA course handicap. Do NOT enter raw handicap index — enter the final adjusted value. The 90% fallback formula has been removed.

Match Play Points (PTS column)

Each hole: better ball net score from each side is compared.

• Team 1 wins hole → ‹ chevron in PTS column, Team 1 gets 1 point
• Team 2 wins hole → › chevron in PTS column, Team 2 gets 1 point
• Halved hole → ◆ diamond, no points
• Incomplete hole → dot placeholder

Subtotal rows show running team point totals at Out and final Total.

Drink Counter

Long-press (or hold) a score button to add a drink for that player on that hole. Drinks also have a manual tracker in the Stats tab for drinks consumed outside of scoring.

Two Views: Tournament & Prince of Wales

Toggle between the two tabs at the top of the leaderboard page.

Tournament View

Shows cumulative team points across all 5 tournament rounds and both pairings. Each team card shows total points and a per-round breakdown row.

Point accumulation rules:

• Points accumulate across all rounds and both pairings — there is no per-round reset
• Individual player points: player earns a point only if (a) their team won the hole AND (b) their net score tied for the lowest net on their side of the pairing
• Practice rounds (Loop Red, Bootlegger) do NOT count toward tournament points

Prince of Wales View

Head-to-head individual match play standings. Each player is matched against their opposite-number pairing partner across rounds. Shows individual W/L/T record.

What Each Stat Tracks

• Total Points — individual match play points across all tournament rounds
• Net Birdies — holes where net score was 1 under par
• Net Eagles — holes where net score was 2+ under par
• Net Bogeys — holes where net score was 1 over par
• Best Round — lowest gross 18-hole total (12-hole rounds excluded)
• Worst Round — highest gross 18-hole total (12-hole rounds excluded)
• Fire Streak — longest consecutive net par-or-better streak in a single round
• Drinks — total drinks (hole-by-hole + manual)

Note: Best/Worst Round explicitly excludes The Dozen (12 holes) to avoid skewing gross totals.

Schedule

Shows the full week schedule from the SCHEDULE array. Each day lists course name, tee times (both groups), and a Practice/Tournament badge. This is a static display — it does not change based on date.

Current tee times:

• Wed 9/30: Loop Red 10:26/10:37am (Practice) · Bootlegger 4:30/4:41pm (Practice)
• Thu 10/1: Forest Dunes 9:24/9:53am · Loop Black 2:50/3:01pm
• Fri 10/2: South Course 1:39/1:50pm
• Sat 10/3: The Dozen 9:06/9:18am · The Bluffs 1:40/1:50pm

What It Shows

A floating banner above the nav bar showing the current round name + "Live Match", with one row per pairing showing match status (e.g. "Warthogs lead 3–1 · Thru 7") and holes played.

The banner floats across all tabs — it persists when you navigate between Home, Score, Leaderboard, etc.

Visibility Rules

Priority System (internal)

• Priority 1 — today's round, in progress → live scores
• Priority 2 — today's round, complete → final result until 9pm
• Priority 3 — outside trip dates, in progress round → live scores (testing)
• Priority 4 — outside trip dates, completed round on its scheduled date → final result until 9pm
• Pre-round — checked first before all priorities; fires only on exact calendar date, 10 min before tee time, zero scores

Once a round's scheduled date has passed, it is permanently excluded from all banner priorities.

Match Status Text

• "Warthogs lead 3–1" / "Grandmas lead 2–1" — in progress
• "Warthogs win 5–1" / "Grandmas win 4–2" — round complete
• "All Square" — tied or pre-round
• "Tied 3–3" — complete, exact tie

Team names are pulled from TEAM_NAMES. Plural team names use "lead"/"win" (grammatically correct for group nouns).

Players

Shows all 8 players with email, phone, handicap index, and tee group. Handicap shows "TBD" in navy until populated. Team badge shows "TBD" until teams are assigned. Tap email/phone to open mail/dialer. All info is hardcoded in PLAYER_INFO — edit the array to update.

Courses

Blueprint-style cards for all 7 courses (2 practice, 5 tournament). Each card shows Location, Par, and Designer in a spec-sheet format. Below that, a 2-column player grid shows each player's course handicap. Player names are navy; handicap values show "—" until populated in COURSES[].players.

Flights

Arrival/departure info for all 8 players. Ben and Nate show "Driving." All other players have editable fields: Date, Time, Airport, Flight # for both arrival and departure. Data stored in Supabase flights table. Permissions: each player can edit their own row; Owen (p7) can edit all rows. Tap a cell to edit inline.

Hall of Quotes

Quotes stored in Supabase quotes table. Any player can add a quote with attribution and context. Quotes persist year to year. Commissioner can delete quotes.

Archives

Three sections: Trip History cards (2022–2026), All-Time Standings table, and Handicap History table. All data is hardcoded in TRIP_HISTORY, ARCHIVE_STANDINGS, and ARCHIVE_HDCP arrays. Must be manually updated after each trip. 2026 trip shows as TBD with tbd:true flag — excluded from standings until updated.

Standings sort order: trips (most first) → wins → ties → losses (fewest first).

App Info

Contains: Add to Home Screen instructions (expandable, with screenshots), Troubleshooting / cache clearing instructions, About section (version, credits), and Commissioner Docs link (visible to Owen only).

Deep link: cticlubhouse.com/#appinfo opens App Info directly and auto-expands the iPhone install instructions.

Supabase Real-Time

The app subscribes to all changes on scores, drinks, manual_drinks, and messages tables via WebSocket. Any score entered by any player on any device updates everyone's scorecard within ~1 second. The connection status dot in the app header shows green (connected) or red (disconnected).

Local Storage Fallback

All scores are also saved to localStorage on the device. On app load, local data renders instantly while Supabase data loads in the background. Supabase always wins on conflict — it overwrites local with server truth on every load.

Service Worker & PWA Caching

The app uses a service worker (sw.js) that caches the HTML, icons, and manifest. Cache version is currently cti-2026-v7. When a new version is deployed:

• The new SW installs immediately (skipWaiting)
• Takes control of all open tabs (clients.claim)
• The page detects the controller change and reloads automatically
• Old cache is deleted on activate

To force a cache bust on deploy: bump the version string in sw.js from cti-2026-v7 to cti-2026-v8, etc.

Deploy Workflow

GitHub repo: ochamberlin7/cti-clubhouse → Netlify auto-deploy on commit (~30 sec). Alternatively, drag-and-drop a zip to Netlify deploys page (costs zero build credits). When dragging, always include all 4 files: index.html, sw.js, manifest.json, apple-touch-icon-2.png.