# Score Predictor Overview

The FanHQ26 **Score Predictor** (/predictor) lets fans call any 2026 World Cup scoreline and receive a pundit-grade AI verdict in 22 words or fewer, then share a broadcast-styled ScoreCard with WhatsApp, X, Facebook, Telegram, LinkedIn, or Copy. The tool is part of the **$29 Tournament Pass**.

## How It Works

Fans pick two teams from a dropdown of every 2026 World Cup nation, dial in the scoreline using steppers, and tap **"Lock prediction"**. After locking, the AI verdict button calls Google's Gemini API with a prompt instructing the model to write **"ONE punchy, banter-flavored verdict (max 22 words). No emojis, no hashtags, no quotation marks. Confident, fun, broadcast-ready."** Scores are NaN-safe coerced and clamped to 0–20.

## Sharing

Once a prediction is locked, a full **"/// SHARE YOUR CALL"** social row unlocks below the ScoreCard. The share text adapts: with a verdict it reads "I predicted [Home X-Y Away] at WC 2026 — AI verdict: '...'. Predict yours at fanhq26.com/predictor"; without a verdict, "My WC 2026 call: [Home X-Y Away]. Lock yours in...". The ScoreCard component itself can also be exported as an image.

## Authentication

The Score Predictor sits behind the **server-side Tournament Pass gate**. The client attaches the Supabase JWT via `passFetch`; the `/api/verdict` endpoint runs `requirePass(req)` first and returns **401** for unsigned-in callers, **402** for signed-in callers without an active pass.

## Pricing

The Score Predictor is part of the **$29 Tournament Pass**, which also unlocks the Ticket Fair-Price Checker, My Schedule, Watch-Party Finder, Prediction Leagues, and stop-loss price-drop alerts.

## Notes

The Predictor is **independent fan content** for the 2026 FIFA World Cup. Outputs are AI-generated banter for entertainment and are not predictions of actual outcomes.