Fifty Web

A web recreation of the old Fifty football app experience.

It includes:

• Live NFL scoreboard (ESPN site API)
• Live/in-game win probability timeline (ESPN summary API)
• Recent drive context + scoring state
• Game chatter feed:
  • X recent search when X_BEARER_TOKEN is configured
  • Reddit-based fallback when no X token is present
• Shareable deep links per game (?game=<eventId>)

Stack

• Node.js 18+ (no framework)
• Server-rendered static frontend from /public
• Lightweight API proxy in server.js

Quick start (local)

npm start

Open:

• http://localhost:3000

Environment variables

Copy .env.example and set values if needed:

• PORT (default 3000)
• HOST (default 0.0.0.0)
• X_BEARER_TOKEN (optional, enables X/Twitter recent-search feed)

API routes

• GET /health
• GET /api/scoreboard
• GET /api/scoreboard?date=YYYYMMDD
• GET /api/game/:eventId
• GET /api/social?home=<home team>&away=<away team>

Deploy to Render (recommended)

This repo includes render.yaml.

1. Push this repo to GitHub.
2. In Render, create a new Blueprint and connect the repo.
3. Render will auto-detect render.yaml and configure the web service.
4. Optional: set X_BEARER_TOKEN in Render environment settings.
5. Deploy and share your public URL.

Deploy with Docker

docker build -t fifty-web .
docker run -p 3000:3000 fifty-web

Notes

• Data source availability can vary by game state and season phase.
• Pregame games may only show matchup predictor percentages until live play starts.
• ESPN response fields can change over time; parsing is defensive but may need updates if upstream contracts shift.