Fairline — Project Resume Point

Canonical entrypoint. Load this first on every session touching Fairline.

Quick Facts

• Repo: /Users/ENVOAI/.openclaw/workspace-theo/sports-hud/
• GitHub: ItsEnvo/fairline-app (private)
• Vercel URL: https://sports-hud.vercel.app
• Stack: Next.js 16 + Tailwind + SQLite + Stripe + OpenAI
• Auth: JWT cookies, bcrypt passwords
• Pricing: Monthly $29 / Yearly $249 (28% savings)
• Trial: 7-day free, no credit card

Current State (as of 2026-03-19)

• ✅ Landing page (cinematic dark design)
• ✅ Auth system (signup/login/account)
• ✅ Paywall middleware (trial/paid gating)
• ✅ Stripe integration (test mode — NOT live)
• ✅ Scan page (value/truth layer, conviction scoring)
• ✅ Live page, Assistant page
• ✅ Odds API integration (Basic plan, key: a8b29a3421d27ac18b8c45472bf0d27c)
• ✅ TheSportsDB + ESPN data layers
• ✅ Player Props engine — real last-10 game logs from ESPN, hit rate tracking
• ✅ Multi-book props comparison (no NBA.com dependency)
• ✅ Props-backed Parlay engine v2 — regressed probability, variance scoring
• ✅ Injury filter — auto-exclude Out/Doubtful players from props + parlays
• ✅ Accuracy tracker v2 — SQLite-based, auto-grade, CLV tracking, ROI analysis
• ✅ Enhanced accuracy UI — Interactive charts, CSV export, better visualizations
• ✅ Live scores integration — Real-time ESPN scores across NBA/NHL/MLB
• ✅ March Madness dashboard — Tournament bracket, upset alerts, cinderella tracker
• ✅ Elite matchup analysis system — H2H performance, defensive rankings, game script analysis
• ✅ Situational filters — back-to-back, home/away badges on props
• ✅ MLB + NHL props support with sport tabs
• ✅ iPad-friendly bottom nav (1200px breakpoint)
• ⚠️ Stripe keys: all placeholder (need live keys)
• ⚠️ JWT secret: placeholder
• ❌ No real Stripe products/prices created

Sports Coverage

• NBA ✅ (props, parlays, scan, live)
• Soccer ✅ (scan, odds)
• MMA ✅ (scan, odds)
• Table tennis ✅ (scan, odds)
• College basketball ✅ (scan, odds)
• MLB ✅ (props, parlays)
• NHL ✅ (props, parlays)

Recent Major Features (March 2026)

1. Player Props engine — real ESPN game logs, hit rate %, confidence scoring
2. Parlay engine v2 — regressed probability, variance-based scoring, no garbage traditional parlays
3. Injury filter — auto-exclude injured/doubtful players
4. Accuracy tracker v2 — SQLite-based storage, auto-grading via ESPN box scores, ROI tracking with unit calculations, CLV placeholder
5. Enhanced accuracy UI — Interactive charts (Chart.js), CSV export, better data visualization, mobile-responsive
6. Live scores integration — Real-time ESPN scores, dedicated /scores page, auto-refresh every 30s
7. March Madness dashboard — Tournament bracket tracking, upset alert system, cinderella tracker, seasonal navigation
8. Elite matchup analysis — H2H performance vs opponent, defensive rankings, pace-adjusted projections, game script predictions
9. Situational context — back-to-back game flags, home/away indicators on props
10. Multi-sport props — MLB + NHL added alongside NBA
11. iPad layout fix — bottom nav visible on tablets
12. Premium UI Upgrade — Confidence ring component, glass-morphism detail panel, enhanced dark theme with glow effects

TODO (priority order)

1. Get Stripe live keys from Envo → replace placeholders in .env.local + Vercel env
2. Create Stripe products — Monthly ($29) + Yearly ($249) price IDs
3. Set real JWT secret in production
4. Smoke test signup → trial → scan → upgrade flow
5. Notification system — Push alerts when tracked picks hit/miss
6. Conviction sliders — User-adjustable confidence thresholds

Key Files

Git Log (recent)

• 7102bd7 feat: premium UI upgrade — Confidence rings, glass-morphism detail panel, enhanced dark theme
• 35a9192 feat: elite matchup analysis system for higher win rates — H2H analysis, defensive rankings, game script predictions
• a8b79e4 feat: March Madness tournament dashboard for 2026 — Tournament bracket, upset alerts, cinderella tracker, seasonal nav
• 2c9ef7f feat: enhanced accuracy UI + live scores integration — Interactive charts, CSV export, real-time ESPN scores
• 66487b8 fix: populate prop breakdown data + show last 10 game values in expanded view
• 8282320 feat: accuracy tracker v2 — SQLite, auto-grade, CLV, ROI tracking, situational filters
• ddd5ec0 fix: live odds refresh — NHL real lines, 30s cache, line-hit indicators
• 075273e fix: better grading status messages
• d8bda2b fix: show bottom nav on iPad
• b5a4f67 feat: injury filter
• acaef6b feat: accuracy tracker + ESPN grading
• 5ccfc9d feat: parlay engine v2
• d5f7b8c feat: props-backed parlays
• b1243e2 feat: MLB + NHL props
• d844610 feat: player props — real game logs
• 306d94c feat: real NBA player props

Decisions Log

• 2026-03-20: Premium UI Upgrade — Replaced text confidence with animated SVG rings, glass-morphism detail panel sections, enhanced dark theme with glow effects and premium polish
• 2026-03-19: March Madness Dashboard — Built tournament-specific features for 2026 NCAA tournament launch
• 2026-03-19: Live Scores + Enhanced Accuracy UI — Added real-time ESPN integration and interactive data visualization
• 2026-03-18: Accuracy Tracker v2 — Major upgrade from localStorage to SQLite with comprehensive tracking
• 2026-03-15: Parlay engine v2 with regressed probability
• 2026-03-14: Player props engine using ESPN game logs (no NBA.com)
• 2026-03-07: Launch alongside PhantomLabs, both need Stripe
• 2026-02-26: The Odds API upgraded to Basic plan
• 2026-02-24: Cinematic surfaced candidates UI, sport router tabs
• 2026-02-22: Full truth/value layer built (v3.3)

Accuracy Tracker v2 Implementation (2026-03-18)

Database Schema:

• predictions table — stores every prop prediction when displayed (auto-save)
• graded table — grading results with actual stats from ESPN
• accuracy_snapshots table — daily rollup stats for performance

New API Endpoints:

• POST /api/accuracy/store — auto-save predictions from props/parlays pages
• POST /api/accuracy/grade — auto-grade via ESPN box scores for completed games
• GET /api/accuracy/stats — accuracy statistics with breakdowns
• GET /api/accuracy/graded — graded predictions history
• GET /api/accuracy/clv — closing line value tracking (placeholder)

UI Enhancements:

• Sport selector (NBA/NHL/MLB)
• ROI tracking with unit calculations (assumes -110 odds, flat 1-unit bets)
• Situational badges on props (back-to-back games, home/away indicators)
• CLV section placeholder for future odds API integration

Migration:

• Props and parlays pages now auto-save predictions via API calls
• Accuracy page completely rebuilt to use server-side data
• Old localStorage system deprecated but still functional