Advanced NHL + PWHL analytics — live shot maps, period summaries, momentum tracking, special teams analysis, push notifications, AI-generated game summaries, player heat maps, goalie analytics, WAR/percentile rankings, AI-powered league power rankings, live draft board, full PWHL analytics suite, hat trick detection with live popups + game summary badges, milestone tracking (hat tricks, shutouts, shorthanded goals, season/career thresholds) with a league-wide feed, xGF% per-game sparkline, and per-team AI narratives.
Live at: eyewallanalytics.com
Contact: matt@eyewallanalytics.com
Support the project: buymeacoffee.com/mattehlers
EyeWall Analytics is a React PWA delivering real-time and historical NHL and PWHL data from the public NHL API, MoneyPuck, HockeyTech, and PWHLPA. It combines live polling, a Cloudflare Worker caching layer, Web Push notifications, Workers AI-generated period/game summaries and matchup analysis, player shot heat maps, MoneyPuck-powered WAR/percentile analytics, true RAPM via ridge regression, AI-powered nightly power rankings, a live draft board with Central Scouting rankings and AI pick analysis, and a full PWHL analytics suite into a mobile-first experience for hockey fans who want to go deeper than the box score.
Users select their league (NHL or PWHL) and team on first launch. All views, colors, and data scope to the selected team. The sport, team, and theme preference are persisted to localStorage and applied on every subsequent load.
| Layer | Technology |
|---|---|
| Frontend | React 18 + Vite, react-router-dom v7 |
| Styling | CSS custom properties (design tokens), no CSS framework |
| Charts | D3 v7, SVG-based IceRink component |
| Player Search | Fuse.js — client-side fuzzy match against the Worker's flat NHL+PWHL player index (GET /players-search-index, ~1,600 players — small enough to ship once per session rather than query per keystroke) |
| Hosting | Cloudflare Pages (auto-deploys from main; dev branch → preview) |
| API Proxy | Cloudflare Pages Functions (functions/) |
| Cache Layer | Cloudflare Worker + KV (eyewall-poller) |
| Database | Supabase Pro (NHL + PWHL player/team/goalie stats, shot events, RAPM, game xG, power rankings, draft data, salaries, milestones) |
| NHL Data Pipeline | Python (eyewall-pipeline) — NHL API + MoneyPuck + Tankathon → Supabase |
| PWHL Data Pipeline | Python (eyewall-pipeline) — HockeyTech + PWHLPA → Supabase |
| Pipeline CI | GitHub Actions — nightly data cron (3 AM ET) + AI pipeline + draft day ingest + PWHL news |
| Push Notifications | Web Push API (VAPID), Service Worker |
| AI | Cloudflare Workers AI — @cf/meta/llama-3.1-8b-instruct-fp8-fast (period/game summaries, predictions, matchup analysis, scouting blurbs, power rankings narratives, draft pick analysis) |
| Analytics Data | MoneyPuck.com CSV (fetched nightly by pipeline) |
| PWHL Data | HockeyTech API (stats, PBP, schedules), PWHLPA PDF (salaries) |
| Draft Data | NHL Central Scouting API + NHL API (live picks) + Tankathon; PWHL static (2025, 2026) |
| User Analytics | PostHog (anonymous event tracking, cookieless) |
| Cap Data | Static carContracts.js (source: PuckPedia); PWHL salaries from PWHLPA PDF |
| Accessibility | WCAG 2.1 AA compliant (Section 508) |
| Testing | Vitest (unit tests), Cypress (E2E), GitHub Actions CI |
canes-analytics-starter/
├── index.html
├── public/
│ ├── sw.js # Service worker (Web Push handler)
│ ├── manifest.json # PWA manifest
│ ├── goal-horn.mp3
│ ├── _headers # Cloudflare cache control headers
│ ├── eyewall-logo.svg/.png
│ └── favicon-*.png / .ico
├── functions/ # Cloudflare Pages Functions (API proxy)
│ ├── nhl-api/[[path]].js
│ ├── nhl-stats/[[path]].js
│ ├── nhl-assets/[[path]].js
│ └── api/notification.js
├── src/
│ ├── App.jsx # Router, layout, sport context, theme init
│ ├── views/
│ │ ├── ShotMapView.jsx/.css # NHL live shot map — season/game history selector (Session 77) lets you browse past seasons/games; disabled+tooltip (not hidden) while a game is live, since a live game always wins the display
│ │ ├── ScheduleView.jsx/.css # NHL schedule
│ │ ├── TeamView.jsx/.css # NHL 6-tab team analytics (Advanced tab: xGF% sparkline)
│ │ ├── PlayersView.jsx/.css # NHL players
│ │ ├── LeagueView.jsx/.css # NHL 5-tab league page
│ │ ├── NewsView.jsx/.css # NHL news feed + Milestones tab toggle
│ │ ├── PWHLShotMapView.jsx # PWHL shot map + PBP metrics — season/game history + Regular Season/Playoffs toggle (Session 77, new capability, not just NHL parity)
│ │ ├── PWHLScheduleView.jsx # PWHL schedule + calendar + playoffs
│ │ ├── PWHLTeamView.jsx # PWHL 5-tab team analytics
│ │ ├── PWHLPlayersView.jsx # PWHL roster + stats + player popup
│ │ ├── PWHLLeagueView.jsx # PWHL 5-tab league page
│ │ ├── PWHLNewsView.jsx # PWHL news feed
│ │ ├── DevReplayView.jsx/.css # Dev-only live game replay (/dev)
│ │ └── DevDraftView.jsx # Dev-only draft simulator (/dev/draft)
│ ├── components/
│ │ ├── Topbar.jsx/.css # Live score, countdown clock, sport switcher
│ │ ├── BottomNav.jsx # Sport-aware bottom navigation
│ │ ├── TeamPicker.jsx # Sport + team selection (NHL + PWHL); active/expansion PWHL split derives from comingSoon (fixed 2026-07 — used to be a 2nd hardcoded list, ignored comingSoon entirely)
│ │ ├── IceRink.jsx/.css # SVG rink — shots, heat map, team-aware
│ │ ├── PWHLPlayerPopup.jsx # PWHL player popup (Stats, Heat Map, Scout, Compare — season-over-season, up to 4 seasons, one fetch per season; Compare tab adds a per-game trend chart for chart-ready metrics (6/11 skater, 2/9 goalie — box-score-backed via /pwhl/player-game-log) alongside the existing tile rows, Session 70)
│ │ ├── PlayerPopup.jsx # NHL player popup (Stats, Analytics, Heat Map, Compare — season-over-season, reuses the seasonTotals already fetched for Stats; Compare tab adds a per-game trend chart for chart-ready metrics (11/18 skater, 8/11 goalie — via the NHL API's own game-log endpoint) alongside the existing tile rows, Session 70)
│ │ ├── GameEvents.jsx/.css # Goal/penalty/win/puck drop popups
│ │ ├── ScoutingTab.jsx/.css # NHL opponent scouting
│ │ ├── DraftTab.jsx/.css # NHL draft board
│ │ ├── NotificationBell.jsx # ⚙️ Settings drawer
│ │ ├── PeriodSummary.jsx/.css # Period/game summary popup + share canvas + hat trick badges
│ │ ├── PWHLPeriodSummary.jsx/.css # PWHL period/game summary popup + share canvas
│ │ ├── ShareButtons.jsx/.css # Shared Save/X/Share buttons across all export cards
│ │ ├── HatTrickPopup # (in GameEvents.jsx) — live hat trick celebration overlay
│ │ ├── MilestonesFeed.jsx # League-wide milestone feed (hat tricks, shutouts, SH goals, season/career thresholds) — tappable into PlayerPopup
│ │ ├── PlayerSearch.jsx/.css # Global NHL+PWHL player search (Topbar) — Fuse.js fuzzy match against the Worker's flat player index
│ │ ├── TeamLogo.jsx/.css # NHL + PWHL team logo renderer
│ │ ├── CalendarView.jsx # NHL calendar month view
│ │ ├── PWHLCalendarView.jsx # PWHL calendar month view
│ │ ├── InfoTip.jsx/.css # Tap-to-open tooltip
│ │ ├── StatBar.jsx/.css # Comparative stat bar
│ │ ├── SeasonComparisonPicker.jsx/.css # Generic N-season selector for season-over-season comparison (NHL + PWHL, not league-specific)
│ │ ├── TeamComparisonPopup.jsx # Team-level season-over-season comparison dialog (NHL + PWHL, box-score stats only) — reuses PlayersView.css's popup/stat-section styles; its Head-to-Head tab also renders an AI narrative card (Session 90) via HeadToHeadNarrativeCard
│ │ ├── GameChipsRow.jsx # Shot map game-selector chip row (NHL + PWHL, shared) — normalized {id, opponentAbbr, opponentColor, myScore, oppScore, isHome} shape, each sport maps its own schedule-row into it
│ │ ├── SeasonChipRow.jsx # Shot map season-selector chip stack (NHL + PWHL, shared) — recent seasons inline + a "More seasons" overflow dropdown for older ones
│ │ ├── SeasonTypeToggle.jsx # Regular Season/Playoffs segmented toggle (NHL + PWHL, shared) — same UI, different wiring per sport (PWHL swaps season_id; NHL filters the fetched season's games by gameType)
│ │ └── DisabledHint.jsx # Tap-triggered "why is this grayed out" tooltip — used by the shot map selector while a game is live
│ ├── hooks/
│ │ ├── useFetch.js # Data fetching + polling (cache: no-store)
│ │ ├── usePushNotifications.js
│ │ ├── usePeriodSummary.js
│ │ └── useWakeLock.js
│ └── utils/
│ ├── nhlApi.js # NHL API calls + KV caching
│ ├── pwhlApi.js # PWHL Worker API calls
│ ├── seasonComparison.js # Pure label/normalization helpers for season-over-season comparison
│ ├── pwhlConfig.js # PWHL team configs (12 teams: 8 established + 4 expansion, all live/selectable)
│ ├── teamConfig.js # NHL 32-team configs; CURRENT_SEASON live-resolved (fallback seed only)
│ ├── seasonClient.js # Shared memoized fetch for /config/seasons (teamConfig.js + pwhlConfig.js) and /config/seasons/comparison (SeasonComparisonPicker)
│ ├── SportContext.jsx # Sport state (NHL/PWHL) + localStorage persistence
│ ├── advancedStats.js
│ ├── supabaseClient.js # DB queries; getTeamXgTrend, getGoalieShots (no car_game filter)
│ ├── playerSearch.js # Fuzzy player search — fetches GET /players-search-index once per session, matches via Fuse.js
│ └── analytics.js
├── src/utils/__tests__/
│ └── *.test.js # Vitest unit tests (10 files, 157 tests)
├── cypress/
│ ├── e2e/
│ │ ├── navigation.cy.js # NHL + PWHL route navigation smoke (all 12 PWHL teams)
│ │ ├── news.cy.js # NHL news
│ │ ├── milestones.cy.js # Milestones feed, team filter dropdown, tap-to-open popup (incl. PWHL milestone self-fetch popup)
│ │ ├── player-search.cy.js # Global player search — open/close, debounce, typo tolerance, NHL+PWHL result correctness, popup opens for both
│ │ ├── pwhl-news.cy.js # PWHL news
│ │ ├── period-summary.cy.js # Game Center
│ │ ├── players.cy.js # NHL players
│ │ ├── pwhl-players.cy.js # PWHL players (4 established teams, full features + 1 expansion team empty-state)
│ │ ├── schedule.cy.js # NHL schedule
│ │ ├── pwhl-schedule.cy.js # PWHL schedule smoke (all 12 teams) + full features (BOS)
│ │ ├── shot-map.cy.js # NHL shot map
│ │ ├── pwhl-shot-map.cy.js # PWHL shot map smoke (all 12 teams) + full features (BOS)
│ │ ├── pwhl-shots-live.cy.js # PWHL + NHL shot map live-mode debug panel, popups, situation chips
│ │ ├── pwhl-dev.cy.js # PWHL dev game replay scrubber
│ │ ├── team.cy.js # NHL team (4 teams, all 6 tabs)
│ │ ├── pwhl-team.cy.js # PWHL team (4 established teams, all 5 tabs, full features + 1 expansion team empty-state)
│ │ ├── league.cy.js # NHL league (all 5 tabs)
│ │ ├── pwhl-league.cy.js # PWHL league (all 5 tabs; standings/leaders scoped to established teams — see Known gaps)
│ │ ├── draft.cy.js # NHL draft board
│ │ ├── TeamPicker.cy.js # Sport + team picker — all 12 PWHL teams selectable with real colors
│ │ ├── theme.cy.js # Light/dark mode
│ │ └── viewports.cy.js # 4 viewports × all views
│ └── support/e2e.js # Custom commands incl. cy.setPWHLTeam()
└── .github/workflows/test.yml
On first launch the user selects NHL or PWHL, then their team. The sport is stored under eyewall:sport and the team under eyewall:team (NHL) or eyewall:pwhl_team (PWHL). SportContext exposes isPWHL throughout the app — all routing, BottomNav tabs, and data fetching scope accordingly. hasTeamConfig() is sport-aware: checks eyewall:pwhl_team when sport is PWHL, eyewall:team otherwise. On team change, the app navigates to / (NHL) or /pwhl/shots (PWHL) before reloading so the correct route initializes.
12 teams, all live and selectable in TeamPicker: BOS (Boston Fleet), MIN (Minnesota Frost), MTL (Montréal Victoire), NY (New York Sirens), OTT (Ottawa Charge), TOR (Toronto Sceptres), SEA (Seattle Torrent), VAN (Vancouver Goldeneyes), plus 4 expansion teams flipped live 2026-07: DET (Detroit), HAM (Hamilton), LV (Las Vegas), SJS (San Jose). Expansion team colors are real (pulled from each team's own *_colors.css design tokens), but logos/team names are still temporary placeholders — no permanent branding revealed yet.
Same mechanism as NHL — applyTeamTheme() sets --team-primary, --team-primary-rgb, --team-canvas, --team-canvas-rgb on :root from displayColor.
CURRENT_SEASON (teamConfig.js) and PWHL_CURRENT_SEASON (pwhlConfig.js) are let, not const — seeded with a fallback value, then updated in place by a fire-and-forget fetch to the Worker's GET /config/seasons at module load (via the shared seasonClient.js). Every team object's season field is a getter, not a plain value, so team.season reflects the live value everywhere it's read without any consuming component needing to change.
One real limitation: if a component destructures const { season } = someTeam once and holds onto that local variable indefinitely instead of re-reading someTeam.season, it'll keep whatever value existed at that moment — a normal JS stale-closure situation, not something the getter mechanism can fix. Confirmed this actually happening in PWHLPlayersView.jsx (its season-picker default via useState(PWHL_CURRENT_SEASON)) — fixed by having it listen for the eyewall:pwhl-season-updated event both teamConfig.js/pwhlConfig.js dispatch on resolution, but any new component built the same naive way could reintroduce this.
Added 2026-07, replacing what used to be a yearly manual flip of CURRENT_SEASON/PWHL_CURRENT_SEASON here, NHL_SEASON in the Worker, and equivalent constants in the pipeline. The Worker's seasons.js is the single source of truth — everything else reads from it rather than resolving independently.
How the frontend consumes it: teamConfig.js and pwhlConfig.js each fire a fetch to GET /config/seasons at module load (via the shared seasonClient.js, which memoizes the in-flight promise so both modules loading on the same page only trigger one real request, not two). The fetch is fire-and-forget — first paint uses the hardcoded fallback seed, and the let binding updates in place once the real value resolves. Every team object's season field is a getter reading that let, so team.season stays live everywhere without touching every consuming component.
Manual override, if live resolution ever misjudges the real season boundary (this has happened once already, from a real bug — see Known Limitations below):
wrangler kv key put --binding=CACHE "config:season:nhl:override" '"20262027"' --remote
wrangler kv key put --binding=CACHE "config:season:pwhl:override" '{"seasonId":9,"seasonType":"regular","startYear":2026}' --remoteNote the --remote flag — without it, wrangler kv commands operate on the local/preview namespace, not the one the deployed Worker actually reads.
Full detail (the NHL/PWHL resolution logic itself, the feed=statviewfeed vs modulekit bug, why PWHL resolution prefers regular seasons over more-recent playoffs) lives in eyewall-poller's own README — this section only covers the frontend-facing side.
Worker URL: https://eyewall-poller.billowing-queen-bf23.workers.dev
| Key | Content | TTL |
|---|---|---|
draft:rankings:2026:{category|all} |
NHL Central Scouting rankings | 24 hr |
draft:picks:2026:{team|all}:{round|all} |
Draft picks (live + historical) | 60s while draft in progress (0 < count < 224), 24 hr once complete |
draft:order:2026:{team|all} |
Known R1 pick order | 24 hr |
narrative:{period}:{gameId}:{carAbbr} |
AI period/game narrative per team perspective | 24 hr |
milestones:{team|all}:{limit} |
Recent milestones (hat tricks, shutouts, SH goals, season/career thresholds) | 1 hr |
player:landing:{id} |
NHL API player landing proxy (bio, headshot, career totals) | 1 hr |
config:season:nhl |
Live-resolved current NHL season (see Live Season Resolution) | 6 hr |
config:season:nhl:override |
Manual override, bypasses live resolution entirely | none (manual) |
| Endpoint | Description |
|---|---|
GET /draft/rankings?category= |
NHL Central Scouting rankings by category |
GET /draft/picks?team=&round= |
Draft picks, filterable by team and/or round |
GET /draft/order?team= |
Known R1 pick order |
POST /draft/analyze |
Workers AI draft pick analysis (secret-protected, X-Poll-Secret header) — called by draft_ingest.py on draft day |
GET /milestones?team=&limit= |
Recent milestones, league-wide by default, optional team filter (default limit 50, max 100) |
GET /player/landing?id= |
Proxies NHL API's /player/{id}/landing — browser can't call it directly (no CORS headers on the NHL side) |
GET /config/seasons |
Live-resolved current NHL + PWHL season, both leagues in one response (see Live Season Resolution) — consumed by seasonClient.js at app boot and by the pipeline's season_lookup.py |
GET /players-search-index |
Flat NHL + PWHL player list ({id, name, team, position, sport}, ~1,600 players) for the global player-search autocomplete — see playerSearch.js / PlayerSearch.jsx. NHL entries may carry teamStale: true + teamSeason when the live season's own roster data doesn't exist yet (e.g. right after an early season flip) and team fell back to the prior season — PlayerSearch.jsx renders these dimmed/italic with a "As of <season>" tooltip rather than presenting a possibly-wrong team as current fact. |
GET /config/seasons/comparison |
Per-league season list with team counts and a comparable flag (season-over-season comparison feature, Session 64) — consumed by SeasonComparisonPicker.jsx via fetchComparisonSeasons() |
GET /team-seasons/compare?team=&seasons= |
Box-score fields only for one team across a comma-separated season list — consumed by TeamComparisonPopup.jsx via fetchTeamSeasonsCompare() |
GET /team-seasons/compare-teams?teams=,&season= |
Box-score fields only for two teams at one shared season — backs the "vs Team" mode's Full Stat Comparison (Session 86), consumed by TeamComparisonPopup.jsx via fetchTeamSeasonsCompareTeams() |
GET /team-seasons/head-to-head?teams=, |
All-time head-to-head record/recent-window/current-streak between two teams across every season — backs the "vs Team" mode's Head-to-Head tab (Session 88), consumed via fetchTeamHeadToHead() |
POST /team-seasons/head-to-head/narrative |
AI narrative layer on top of the head-to-head stats above (Session 90) — posts the already-fetched record/window/streak payload back to the Worker, called directly via fetch() (not through nhlApi.js) by HeadToHeadNarrativeCard in TeamComparisonPopup.jsx, same pattern as PeriodSummary.jsx's narrative calls |
| Key | Content | TTL |
|---|---|---|
pwhl:standings:{season} |
All 12 teams' standings + L10 + streak | 1 hr |
pwhl:players:{teamId}:{season} |
Skaters + goalies + roster | 1 hr |
pwhl:schedule:{teamId}:{season} |
Team schedule with scores + dates | 30 min |
pwhl:shots:{teamId}:{gameId} |
Shot events for a game | 6 hr |
pwhl:pshots:{playerId}:{season} |
Player shot coordinates for heat map | 6 hr |
pwhl:salaries:{teamId}:{season} |
Team salary data | 24 hr |
pwhl:leagueplayers:{season} |
All 12 teams' skaters + goalies | 2 hr |
pwhl:news |
Aggregated PWHL news articles | 30 min |
pwhl:narrative:{period}:{gameId}:{carAbbr} |
AI period/game narrative per team perspective | 24 hr |
config:season:pwhl |
Live-resolved current PWHL season {seasonId, seasonType, startYear} |
6 hr |
config:season:pwhl:override |
Manual override, bypasses live resolution entirely | none (manual) |
| Endpoint | Description |
|---|---|
GET /pwhl/standings?season= |
Standings + L10 + streak from game log |
GET /pwhl/players?teamId=&season= |
Team skaters + goalies + roster |
GET /pwhl/schedule?teamId=&season= |
Team schedule |
GET /pwhl/shots?teamId=&gameId= |
Game shot events |
GET /pwhl/player-shots?playerId=&season= |
Player shot history for heat map |
GET /pwhl/pbp?gameId= |
Play-by-play events |
GET /pwhl/scout (POST) |
Workers AI scouting report |
GET /pwhl/salaries?teamId=&season= |
Team salary data |
GET /pwhl/league-players?season= |
All 12 teams' players (Leaders tab) |
GET /pwhl/player/landing?id=&season= |
Single player's identity + one season's stat line, merged — powers PWHLPlayerPopup's self-fetch-by-id (same role /player/landing plays for NHL's PlayerPopup). season pins the stat line to that season_id; omitted, falls back to the most recent regular-season row |
GET /pwhl/player/career?id= |
Career Regular Season / Playoffs totals — powers PWHLPlayerPopup's Career tile sections. playoffs is null if the player hasn't made the playoffs yet |
GET /pwhl/news |
PWHL news feed |
POST /pwhl/news/ingest |
Accept articles from GH Actions pipeline |
POST /pwhl/news/bust |
Invalidate news cache |
POST /pwhl/cache/bust?secret=&teamId=&season= |
Invalidate one team's KV caches for a given season. Bust only after confirming the underlying data is actually correct (direct Supabase query or a fresh Worker hit) — busting first just repopulates the same stale/empty entry if the fix hasn't landed yet. Learned this the hard way during the 2026-07 expansion rollout. |
GET /pwhl/summary?gameId= |
HockeyTech gameSummary normalized (goals, MVPs, team stats) |
POST /pwhl/summary/narrative?gameId=&period=&carAbbr= |
AI period/game narrative per team perspective |
GET /pwhl/team-seasons/compare?teamId=&seasons= |
Box-score fields only for one team across a comma-separated season_id list — PWHL analog of /team-seasons/compare, consumed by TeamComparisonPopup.jsx via fetchPWHLTeamSeasonsCompare() |
GET /pwhl/team-seasons/compare-teams?teamIds=,&season= |
Box-score fields only for two teams at one shared season_id — PWHL analog of /team-seasons/compare-teams (Session 86), consumed by TeamComparisonPopup.jsx via fetchPWHLTeamSeasonsCompareTeams() |
GET /pwhl/team-seasons/head-to-head?teamIds=, |
All-time head-to-head record/recent-window/current-streak between two teams — PWHL analog of /team-seasons/head-to-head (Session 88), consumed via fetchPWHLTeamHeadToHead() |
POST /pwhl/team-seasons/head-to-head/narrative |
AI narrative layer on top of the head-to-head stats above (Session 90) — PWHL analog of /team-seasons/head-to-head/narrative |
All existing NHL features unchanged — see original documentation. Key features:
- Live shot map with momentum, insights, PP/PK drill-downs
- Period summaries with AI narrative, goals carousel, share export
- 6-tab team page (Overview, Advanced, Splits, Trends, Cap, Picks)
- League page (Standings, Bracket, Leaders, Power Rankings, Draft)
- Player analytics (WAR, RAPM, GSAX, heat maps)
- Push notifications (goal, game start, penalty, win)
Shot Map — Same IceRink component as NHL. Corsi/Fenwick panel (no missed shots in HockeyTech — FF% is SOG-based proxy). PP/PK analysis drill-downs. Season picker (2023-24 / 2024-25 / 2025-26). Faceoff events from PBP (HockeyTech homeWin string "0"/"1" fix applied).
Schedule — Regular season cards with SortBar (newest/oldest), calendar toggle, venue city. Playoffs tab with best-of-5 SeriesCards (3 pips), Walter Cup Final label, "View Shot Map →" navigation.
Team Page (5 tabs):
- Overview — W–OTW–OTL–L record (3-2-1-0 points system), season stats grid (GF/GP, GA/GP, Diff, PP%, PK%, SOG/GP, SA/GP) with league rank badges, top scorers, starting goalie card
- Advanced — CF%/FF% from
pwhl_shot_events, PDO, special teams PP%/PK%, league context rankings, playoff toggle - Splits — Home vs Away side-by-side (Pts%, GF/GP, GA/GP, Diff), Regular Season / Playoffs toggle
- Trends — Streak, L10, result dots, rolling 10-game win%, rolling 5-game GF/GA, goal differential waterfall
- Salaries — Total payroll vs $1.3M cap ceiling, CBA target ($58,349.50/player ±10%), Avg vs Target, player salary bars
Players Page — Photo grid roster (Forwards / Defencemen / Goalies), season picker, sortable stats tables. Player popup with Stats, Heat Map (from pwhl_shot_events), and Scout (Workers AI on-demand) tabs.
League Page (5 tabs):
- Standings — W/OTW/OTL/L columns, PTS, Pt%, GF, GA, DIFF, L10 dots, STRK. 3-2-1-0 points note. Sortable.
- Playoff Bracket — Semifinals + Walter Cup Final, best-of-5 (3-win pips), series modal with game-by-game results and dates
- Leaders — Points, Goals, GAA, SV% top 10. Click → player popup
- Power Rankings — 5-factor weighted formula (Pts% 35%, L10 20%, GD/GP 20%, CF% 15%, Special Teams 10%), collapsible formula card
- Draft — 2026 (72 picks, 12 teams) and 2025 (48 picks, 8 teams) with position and round filters
News — Aggregated from Sportsnet, The Score, and others. Fetched by GH Actions pwhl_news.py and POSTed to Worker (CF datacenter IPs are blocked by RSS sources). 30-min KV cache.
The PWHL uses a 3-2-1-0 points system:
| Result | Points |
|---|---|
| Regulation win | 3 |
| OT/SO win | 2 |
| OT/SO loss | 1 |
| Regulation loss | 0 |
All standings, record displays (W–OTW–OTL–L), and Splits calculations use this system.
Repo: github.com/ehlersio/eyewall-pipeline
| Module | Description |
|---|---|
nhl_stats.py |
Rosters, skater/goalie/team stats, game log → Supabase |
shot_events.py |
League-wide shot coordinates |
shift_data.py |
Shift charts |
zone_starts.py |
Per-player OZ/DZ/NZ start counts |
score_state.py |
Score-state ice time distribution |
rapm.py |
3-year rolling ridge regression RAPM |
moneypuck.py |
WAR + percentiles + GSAX + xGF% |
power_rankings.py |
32-team rankings + AI narratives (per-team KV cache) |
ai_scouting.py |
AI scouting blurbs for skaters + goalies (all 32 teams) |
special_teams.py |
PP/PK unit inference |
draft_ingest.py |
Live draft pick polling + AI analysis + one-time backfill (/draft/picks/{year}/all) for a completed draft |
tankathon_ingest.py |
2026 pick order scraper |
milestones.py |
Nightly milestone detection (hat tricks, natural hat tricks, shorthanded goals, shutouts, season goal/point thresholds, career point/win thresholds via live NHL API lookup) → milestones table |
| Module | Description |
|---|---|
db.py |
Supabase client (get_client(), tuned postgrest_client_timeout=120), NHL_SEASON (live-resolved via season_lookup.py as of 2026-07, .env value now just a fallback), PRIMARY_TEAM_ABBR, batched upsert(). The canonical shared module — everything below imports from here rather than creating its own Supabase client. |
pipeline_common.py |
Everything db.py doesn't cover: nhl_get() (NHL API GET helper) and get_logger() (shared logging config). |
season_lookup.py |
Added 2026-07. Reads the current NHL/PWHL season from the Worker's GET /config/seasons, with the .env values as fallback if the Worker's unreachable. db.py, pwhl_stats.py, pwhl_salaries.py all consume this rather than resolving independently. See eyewall-poller's README for the full resolution chain. |
nhl_stats.py, draft_ingest.py, milestones.py, ai_context.py, and ai_scouting.py all import from db.py/pipeline_common.py rather than duplicating Supabase client setup — consolidated after draft_ingest.py and milestones.py were briefly built against a since-retired standalone pipeline_common.get_supabase() before db.py's existing role was accounted for.
| Module | Description |
|---|---|
pwhl_stats.py |
Rosters, skater/goalie/team stats, special teams (PP%/PK%), game log with dates, Corsi/Fenwick from shot events. TEAM_ID_MAP/CITY_TEAM_MAP include the 4 expansion teams (2026-07). |
pwhl_pbp_events.py |
PBP events (faceoffs, hits, penalties) → pwhl_pbp_events |
pwhl_shot_events.py |
Shot events with coordinates → pwhl_shot_events |
pwhl_salaries.py |
PWHLPA PDF salary scraper → pwhl_salaries (190/194 player matches). SEASON_LABEL now derived from the live-resolved season (2026-07 fix — used to be separately hardcoded, same bug shape as moneypuck.py's old MP_URL). |
pwhl_news.py |
RSS news fetcher → POST to Worker /pwhl/news/ingest |
pwhl_players (no season dimension — one row per player, current team assignment only), pwhl_player_seasons, pwhl_goalie_seasons, pwhl_team_seasons (incl. pp_pct, pk_pct, corsi_for_pct, fenwick_for_pct), pwhl_game_log (incl. game_date, venue_name, venue_city), pwhl_shot_events, pwhl_pbp_events, pwhl_salaries, pwhl_teams (team master — pwhl_players.team_id has a foreign key against this table; a new team_id must be seeded here first or roster upserts fail with a 23503 FK violation)
| ID | Season | Type |
|---|---|---|
| 1 | 2023-24 | Regular |
| 3 | 2023-24 | Playoffs |
| 5 | 2024-25 | Regular |
| 6 | 2024-25 | Playoffs |
| 8 | 2025-26 | Regular |
| 9 | 2025-26 | Playoffs |
| 10 | 2026-27 | Pre-Season (current as of 2026-07; hidden from standings, no games yet) |
IDs 2, 4, 7 are real preseason entries confirmed via HockeyTech's bootstrap response (2026-07) — not missing/gapped as previously assumed here, just hidden from standings with little game data. Separately: pwhl_stats.py's SEASON_TYPE_MAP labels ID 2 as "showcase", but the real bootstrap response names it "2024 Preseason" — an unresolved discrepancy, not silently changed either way. See the pipeline README for detail.
| Workflow | Schedule | Description |
|---|---|---|
nightly.yml |
3 AM ET daily | Full NHL pipeline (NHL-only after split) + milestones.py (runs after python run.py, once game_scoring is fresh) |
pwhl-nightly.yml |
3:20 AM ET daily | PWHL PBP events + PWHL news (20 min offset to avoid Supabase contention) |
moneypuck-ingest.yml |
Nightly | MoneyPuck CSV fetch via GH runner |
reddit-ingest.yml |
Every 30 min | Reddit (32 subreddits) + SBNation atom feeds → Worker |
tankathon-sync.yml |
Weekly (Tue 8am ET) | Tankathon draft order scrape |
draft-ingest.yml |
Jun 26 + Jun 27 | Live NHL draft pick polling loop |
npm test
npm run test:watchnpm run cypress:open
npm run cypress:run
npm run cypress:full # Clean → run → HTML report20 spec files:
Note (2026-07, Session 38): the PWHL expansion coverage gap flagged below (Session 34, carried through Session 37) is now closed. navigation.cy.js, pwhl-schedule.cy.js, and pwhl-shot-map.cy.js smoke-test all 12 PWHL teams; pwhl-team.cy.js and pwhl-players.cy.js add an explicit expansion-team (DET) case asserting the correct empty state (no games played yet — see Known gaps); pwhl-league.cy.js's standings/leaders tests are scoped to the 8 established teams on purpose, with an explicit assertion that expansion teams are not yet present (real data fact, not a bug); TeamPicker.cy.js is new and covers all 12 teams rendering as selectable with real brand colors.
| Spec | Coverage |
|---|---|
navigation.cy.js |
NHL routes + PWHL 12-team smoke (all 7 PWHL routes) |
news.cy.js |
NHL news, source filters |
milestones.cy.js |
Milestones feed, team filter dropdown, card structure, tap-to-open player popup |
pwhl-news.cy.js |
PWHL news, source chips, article list |
period-summary.cy.js |
Game Center, period/game summary popups |
players.cy.js |
NHL roster, skater/goalie cards (4 teams) |
pwhl-players.cy.js |
PWHL roster, stats, player popup (4 established teams) + 1 expansion team (empty stats state) |
schedule.cy.js |
NHL schedule, predictions |
pwhl-schedule.cy.js |
PWHL schedule smoke (12 teams), full features (BOS), playoffs tab |
shot-map.cy.js |
NHL shot map, all sections; season/game history selector (chips, "More seasons" overflow, Reg/Playoffs toggle), disabled+tooltip state during a live game |
pwhl-shot-map.cy.js |
PWHL shot map smoke (12 teams), full features (BOS), PBP metrics, Reg/Playoffs toggle |
pwhl-shots-live.cy.js |
PWHL + NHL shot map live-mode debug panel, goal/penalty/win popups, situation chips |
pwhl-dev.cy.js |
PWHL dev game replay scrubber |
team.cy.js |
NHL 6 tabs (4 teams incl. Cap + Picks) |
pwhl-team.cy.js |
PWHL 5 tabs (4 established teams incl. Salaries) + 1 expansion team (empty-state across Splits/Trends/Salaries) |
league.cy.js |
NHL 5 tabs |
pwhl-league.cy.js |
PWHL 5 tabs incl. Draft (72 picks); standings/leaders scoped to established teams, expansion absence asserted |
draft.cy.js |
NHL draft board |
TeamPicker.cy.js |
Sport + team picker — all 12 PWHL teams selectable, real colors |
theme.cy.js |
Light/dark mode |
viewports.cy.js |
4 viewports × all views |
npm install
npm run dev # http://localhost:5173
npm test
npm run buildRequired .env.local:
VITE_WORKER_URL=https://eyewall-poller.billowing-queen-bf23.workers.dev
VITE_VAPID_PUBLIC_KEY=BHuReh0oBGitFpWQpzEkxM-0m2XHxDX3hqfvX6lpA-IfKSivoB892Jvs64Uz7oNOF-NvDIpPeeBAcWwsIRpnKX4
VITE_POSTHOG_KEY=phc_...
Dev tools:
http://localhost:5173/dev— live game replay scrubberhttp://localhost:5173/dev/draft— draft simulator
App: push to dev → verify → merge to main → auto-deploys to Cloudflare Pages.
Worker: edit worker.js, paste into Cloudflare Workers dashboard → Deploy.
October season prep checklist:
Most of this is now automatic (2026-07) — see Live Season Resolution. What's left:
Update— automatic now, live-resolved at app bootCURRENT_SEASONinteamConfig.jsUpdate— automatic nowPWHL_CURRENT_SEASONinpwhlConfig.jsUpdate— fallback-only now, safe to leave staleNHL_SEASONandPWHL_SEASONGitHub Actions secretsUpdate— automatic now, derived fromMP_SEASONinmoneypuck.pyNHL_SEASON- Update
OFFSEASON_BRACKETinLeagueView.jsx— still manual, not touched during the 2026-07 season-resolution work Add PWHL expansion team IDs to— done 2026-07 (DET=10, HAM=11, LV=12, SJS=13)pwhlConfig.js- Review Dependabot PRs (ESLint 10, Vite 8, supabase 2.31.x) — still manual, unrelated to season resolution
- New for future expansion waves: if HockeyTech assigns another new team_id, remember:
pwhl_teamsneeds the new team_id seeded before roster fetches succeed (FK constraint), roster data needs the literal current/preseason season_id rather than the "current regular season" default, and bust the Worker's KV cache only after confirming the data is actually correct — not before. All three cost real debugging time during the 2026-07 rollout; seeeyewall-pollerandeyewall-pipelineREADMEs for the full story.
- Cron minimum: 1-minute polling — live NHL data is 0–60s behind the API.
- PWHL news: RSS feeds block Cloudflare datacenter IPs. GH Actions runner fetches and POSTs to Worker. Low volume in offseason; improves when season starts.
- PWHL Corsi/Fenwick: No missed shot data in HockeyTech — FF% is SOG-based proxy, not true Fenwick.
- PWHL PDO (playoffs): Requires playoff player-level shot data not yet separated in pipeline. Regular season PDO only.
- PWHL Analytics tab: Post-launch work — requires building PWHL xG model and WAR equivalent.
- Cap data: NHL API doesn't expose salary. Static file requires manual updates.
- iOS push: Requires Add to Home Screen — browser Safari cannot receive Web Push.
- WAR/RAPM: Beta — zone-start OZS% still being refined. Non-CAR players have high variance.
- Reddit ingest: Blocked by Reddit on GH Actions IPs. Deferred to October.
- X/Twitter posting: Built but requires Basic tier ($100/mo).
- PWHL expansion team logos/names: Real colors and roster data are live (2026-07), but logos and permanent team names are still placeholders — no official branding revealed yet. Expected this fall.
- PWHL expansion teams have no games yet (confirmed 2026-07 against the live Worker): DET/HAM/LV/SJS have real rosters but empty schedule/skater-goalie-stats/standings/salaries until the 2026-27 season starts. Every data-driven view handles this gracefully (
PWHLScheduleView,PWHLShotMapView,PWHLPlayersView's Stats tab, andPWHLTeamView's Splits/Trends/Salaries tabs all show an explicit empty-state message) — exceptPWHLTeamView's Advanced tab, which shows "Loading advanced stats…" permanently for these teams instead of an explicit no-data message, since it early-returns on a missing standings row rather than distinguishing "still loading" from "no row will ever exist yet." Worth a copy fix, not covered by Cypress on purpose (would be asserting on a known-misleading string). - Cache-busting order matters (learned 2026-07): busting the Worker's KV cache before confirming the underlying data fix has actually landed just repopulates the same stale/empty entry. Always confirm the data first, then bust.
- HockeyTech
bootstrapfeed type: it'sfeed=statviewfeed, notfeed=modulekit— the latter returns a 200 OK with no real payload, which silently masqueraded as a working fallback for a while. If a HockeyTech URL is built from a written description rather than a captured real request, verify against actual DevTools traffic before trusting it. - PWHL season resolution prefers regular seasons over playoffs, deliberately: almost every
/pwhl/*Worker endpoint filtersseason_type=eq.regulardownstream, so resolving to a playoffs-type season_id breaks every PWHL view even for teams that played in that postseason. Shipped once without this preference and broke Cypress across every PWHL view before being caught.
- PWHL full analytics suite (Shot Map, Schedule, Players, Team, League, News)
- PWHL pipeline (stats, PBP events, shot events, salaries, news)
- PWHL salary data from PWHLPA PDF (190/194 player matches)
- PWHL Corsi/Fenwick from shot events
- PWHL special teams (PP%/PK%) from HockeyTech
- PWHL L10 + streak in standings
- PWHL 2026 draft tab (72 picks, 12 teams) + 2025 draft
- PWHL power rankings (5-factor formula with CF%)
- PWHL playoff bracket with series modal
- PWHL player heat maps + AI scouting
- Sport picker (NHL/PWHL) with full team picker
- Cypress tests for all PWHL views (20 spec files total)
- ESLint clean (0 errors, 0 warnings) — maintained throughout offseason
- xGF% per-game sparkline on Advanced tab (L10 / Season toggle, hover tooltip)
- Per-team AI narrative KV caching (carAbbr in key — all 32 teams get own perspective)
- AI scouting blurbs for goalies (goalie-specific prompt, GSAX/SV% metrics)
- Goalie heat map car_game filter removed (now shows all shots faced, not just CAR games)
- PWHL/NHL sport switching bug fixed (hasTeamConfig sport-aware, correct root redirect)
- Period summaries centered modal (not bottom sheet)
- ShareButtons centered across all export cards
- Power rankings AI narrative fixed (CF API key + Workers AI permission scope)
- DevReplayView Clear & Reset button + auto-clear session keys on game load
- PWHL news pipeline fixed (1 → 22 articles/run; Women's Hockey Life + OurSports Central)
- Share buttons unified across all 5 export card types (useShareCard hook)
- NHL Draft Board shipped (Sessions 19-20)
- Hat trick live popup (NHL + PWHL) — Phase A complete
- Hat trick badge in period/game summary cards (natural hat trick detection) — Phase B complete
- Hat trick / milestones pipeline + feed — Phase C complete:
milestones.pynightly detection (hat tricks, natural hat tricks, SH goals, shutouts, season goal/point thresholds, career point/win thresholds via live NHL API lookup),/milestones+/player/landingWorker endpoints, league-wide Milestones tab on News page with team-logo filter dropdown, tappable into PlayerPopup - Draft pick field-name bug fixed (
firstName/lastNameare top-level{"default": ...}objects, not nested underprospect/draftedPlayer— was silently writing blank names for all round-1 picks) + one-time--backfill-picksmode using/draft/picks/{year}/all - Cloudflare KV cache TTL bug fixed (empty results were getting the 24hr branch instead of 60s — could pin a stale/empty snapshot for a full day)
-
draft-ingest.ymlKV purge step fixed (was calling the wrong Cloudflare endpoint —/keys/instead of/values/— silently never worked) - Shared pipeline modules consolidated —
draft_ingest.py,milestones.py,ai_context.py,ai_scouting.pynow all usedb.py'sget_client()instead of each duplicating Supabase client setup - Live season resolution (2026-07) —
NHL_SEASON/PWHL_CURRENT_SEASON/etc. no longer need a yearly manual flip across 3 repos. Worker'sseasons.jsresolves live from NHL/HockeyTech APIs, exposed viaGET /config/seasons; frontend (seasonClient.js) and pipeline (season_lookup.py) both read from it with fallback. Caught and fixed two real bugs along the way: a wrong HockeyTech feed type (modulekitvsstatviewfeed) that silently masked all along, and a season-type mismatch (playoffs vs regular) that broke every PWHL view in production before being caught via Cypress. - PWHL expansion teams (DET, HAM, LV, SJS) fully wired 2026-07 — HockeyTech IDs, real rosters (confirmed via direct HockeyTech fetches), real WCAG-checked colors from each team's own
*_colors.css,TeamPickerselectable (fixed a real bug where it had its own hardcoded active/expansion list, ignoringcomingSoonentirely) - Vitest test suite added for
eyewall-poller(previously had zero test infrastructure) — coversseasons.js's resolution logic, including regression tests for both bugs found above - Cypress PWHL expansion team coverage gap closed (2026-07, Session 38) —
navigation.cy.js/pwhl-schedule.cy.js/pwhl-shot-map.cy.jssmoke all 12 teams;pwhl-team.cy.js/pwhl-players.cy.jsadd an expansion-team (DET) case asserting the correct empty state;pwhl-league.cy.jsstandings/leaders explicitly assert expansion teams are absent (real data fact — no games played yet, not a bug); newTeamPicker.cy.jscovers the Session 34comingSoonbug with an actual regression test (previously had zero coverage)
- PWHL Analytics tab (xG model, WAR equivalent) — post-launch
- PWHL PDO in playoffs (needs playoff player shot data)
- Reddit ingest fix — October
- PuckPedia integration (contracts + future picks, all 32 teams)
-
app_configSupabase table to eliminate hardcoded season constantsseasons.js+GET /config/seasons) rather than a Supabase table. Same goal, different mechanism — closing this out rather than leaving it looking unstarted. - Season-over-season player comparison
- Standings clinching indicators
- Capacitor PWA wrapper for App Store / Play Store
- Dependabot: supabase 2.31.x, ESLint 10, Vite 8 (October)
- October: bump
OFFSEASON_BRACKET— the only one of these four left after 2026-07's live season resolution work;CURRENT_SEASON/PWHL_CURRENT_SEASON/NHL_SEASONno longer need a manual bump - PWHL milestones (hat tricks, shutouts, etc.) — deferred pending PWHL schema confirmation, same pattern as NHL
milestones.py -
ai_summaries.py/ai_predictions.pyappear to run twice nightly — once insiderun.py'srun_all(), again viaai_pipeline.yml's separate cron an hour later. Worth confirming whether that's intentional redundancy or wasted GH Actions minutes / duplicate Workers AI calls. - Migrate remaining pipeline scripts (
ai_summaries.py,ai_predictions.py,moneypuck.py, etc.) todb.py/pipeline_common.pyif they don't already use them - Expansion team logos/permanent names — still placeholders, waiting on official branding reveal (likely this fall)
-
pwhl_stats.py'sSEASON_TYPE_MAPlabels season ID 2 as"showcase", but HockeyTech's ownbootstrapresponse calls it"2024 Preseason"— unresolved discrepancy, worth checking against real 2024 game data before changing either one
Built with 🌀 for hockey fans