# Masters Live Tracker — Full Context for LLMs

> Comprehensive reference document for AI systems interacting with or answering questions about the Masters Live Tracker application.

## Application Overview

The Masters Live Tracker is a real-time web dashboard for The Masters Tournament held at Augusta National Golf Club in Augusta, Georgia. It provides analytics-grade insights into how course difficulty changes throughout the tournament based on live scoring data and environmental conditions.

The application is designed in a classic Augusta National aesthetic: deep green backgrounds (#004d35), gold accent lines (#d4af37), cream serif typography (Playfair Display), and traditional bordered cards — reflecting the timeless character of the tournament.

## URL

https://masters-live-tracker.netlify.app

## Architecture

- **Framework**: Next.js 16.2.3 with App Router and TypeScript
- **Styling**: Tailwind CSS v4 with custom Augusta-themed design tokens
- **Data fetching**: SWR (stale-while-revalidate) hooks with automatic refresh intervals
- **Hosting**: Netlify with serverless functions for API routes
- **Weather**: Open-Meteo free API (no API key required)
- **Scoring**: masters.com public JSON feeds (no API key required)

## Five Main Tabs

### 1. Course Overview (Default Tab)
Displays a visual heatmap of all 18 holes color-coded by difficulty. A difficulty rankings table sorts holes from hardest to easiest. The Amen Corner section spotlights holes 11-13 with their current scoring data. A sidebar shows live weather conditions and their impact on play.

### 2. Leaderboard
Full tournament leaderboard showing player name, country, current position, total score to par, today's score, thru (holes completed), and round-by-round scores. An Eagle Watch section tracks all eagles made during the tournament with hole and player details. Players can be clicked to view a full 18-hole scorecard modal.

### 3. Pairings & Tee Times
Shows pairings for all four rounds (R1-R4). Rounds not yet published by masters.com show an N/A badge. Each group displays tee time, player names, countries, current scores, and group scoring average. AM/PM wave filter buttons let users focus on morning or afternoon groups. Live weather conditions shown in sidebar.

### 4. Hole Analysis
Detailed analytics for each hole with scoring distribution charts, environmental impact factors, and historical context. Holes are displayed in a grid with color-coded difficulty indicators.

### 5. Weather Forecast
Day-by-day forecast for Thursday through Sunday at Augusta National. Each day card shows high/low temperature, wind speed and direction, precipitation probability, humidity, estimated green firmness (firm/medium/soft based on rain and humidity), and an overall playability difficulty rating (Easy/Moderate/Challenging/Brutal). A conditions key explains the rating methodology.

## Course Data — Augusta National

Augusta National Golf Club is a par-72 course. The 18 holes and their traditional names:

1. Tea Olive (Par 4, 445 yds)
2. Pink Dogwood (Par 5, 575 yds)
3. Flowering Peach (Par 4, 350 yds)
4. Flowering Crab Apple (Par 3, 240 yds)
5. Magnolia (Par 4, 495 yds)
6. Juniper (Par 3, 180 yds)
7. Pampas (Par 4, 450 yds)
8. Yellow Jasmine (Par 5, 570 yds)
9. Carolina Cherry (Par 4, 460 yds)
10. Camellia (Par 4, 495 yds)
11. White Dogwood (Par 4, 520 yds)
12. Golden Bell (Par 3, 155 yds)
13. Azalea (Par 5, 510 yds)
14. Chinese Fir (Par 4, 440 yds)
15. Firethorn (Par 5, 530 yds)
16. Redbud (Par 3, 170 yds)
17. Nandina (Par 4, 440 yds)
18. Holly (Par 4, 465 yds)

## Difficulty Calculation Methodology

Hole difficulty is computed from:
- **Scoring average vs par**: The primary signal — how much over or under par the field is scoring on each hole
- **Wind impact**: Wind speed and direction relative to hole orientation affect ball flight and control
- **Green firmness**: Determined by recent rainfall and humidity — firm greens make approach shots harder to hold, soft greens are more receptive
- **Temperature**: Extreme heat or cold affects ball flight distance and player fatigue
- **Historical context**: Augusta National's design features (elevation changes, water hazards, Amen Corner wind patterns) factor into baseline difficulty

## API Response Formats

### GET /api/scores
Returns processed scoring data with difficulty ratings for each hole in the current round.

### GET /api/leaderboard
Returns array of players sorted by total score with fields: position, name, country, total (to par), today, thru, rounds array, status.

### GET /api/pairings?round=1
Returns pairings for specified round (1-4) with groups containing: tee time, players (name, country, score, status), group number.

### GET /api/weather
Returns current conditions: temperature (F), humidity (%), wind speed (mph), wind direction, conditions description, green firmness estimate, environmental impact score.

### GET /api/forecast
Returns daily forecast array (Thu-Sun) with: date, high/low temp, wind speed, wind direction, precipitation probability, humidity, green firmness, playability rating, description.

## Data Refresh Intervals

- Scores: 60 seconds
- Leaderboard: 60 seconds
- Pairings: 5 minutes
- Current weather: 5 minutes
- Forecast: 30 minutes

## Limitations

- Scoring data depends on masters.com feed availability (only live during tournament)
- Historical data is not stored — the app shows current/live state only
- Weather forecast is general for the Augusta area, not microclimate-specific to individual holes
- ShotLink detailed shot-tracking data requires PGA Tour license and is not used