josh 3d77c7cd5a
All checks were successful
CI / Lint (push) Successful in 7s
CI / Test (push) Successful in 6s
CI / Build & Push (push) Successful in 17s
feat: PWA support with hockey puck icon
Adds full PWA compliance: web app manifest, service worker with
cache-first static / network-first scoreboard strategy, and a
generated hockey puck icon (512, 192, 180, 32px) on the app's
dark navy background. Includes all required meta tags for iOS
standalone mode and a /favicon.ico route.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-29 19:04:33 -04:00
2026-03-29 18:41:10 -04:00
2026-03-29 09:20:21 -04:00

NHL Scoreboard Web App

A web application that displays live NHL game scores, team statistics, and game states in real-time. Retrieves data from the NHL API and surfaces the most interesting games first using a hype scoring algorithm.

Features

  • Live NHL game scores, shots on goal, and game state
  • Power play indicators with live countdown clock
  • Smooth period and intermission countdown clocks
  • Hype Meter — ranks games by how exciting they are right now, factoring in:
    • Period, time remaining, and score differential
    • Late-game urgency and comeback bonuses
    • Power play situations
    • Game importance — boosts standings-relevant matchups late in the season, with extra weight for division and conference rivals fighting for playoff spots

Hype Scoring

Games are sorted by a priority score combining in-game excitement and contextual importance:

Factor Description
Period & time Later period and deeper into it = higher base score
Score differential Close games rank higher; blowouts are penalized
Late urgency Bonus for ties and 1-goal games in the final 12 minutes
Comeback One-time spike when the trailing team scores to pull within 2
Power play Bonus for an active man advantage, scaling with game situation
Game importance Season-progress × playoff-bubble proximity × rivalry multiplier (max +150 pts)

Game importance ramps up sharply after ~game 55 of 82, peaks for teams fighting for the last wildcard spot, and applies a 1.4× bonus for division games and 1.2× for conference games.

Technologies Used

  • Python / Flask — backend and API polling
  • SQLite — standings cache (refreshed every 10 minutes)
  • HTML / CSS / JavaScript — frontend with auto-refresh every 10 seconds

Installation

  1. Clone the repository:

    git clone https://github.com/your-username/nhl-scoreboard.git
    
  2. Install dependencies:

    pip install -r requirements.txt
    
  3. Run the application:

    python run.py
    
  4. Open http://localhost:2897 in your browser.

Credits

Data provided by the NHL via their public API.

License

MIT License

Description
NHL Scoreboard Without Fluff
Readme 332 KiB
Languages
Python 79.5%
JavaScript 11.1%
CSS 7.2%
HTML 1.7%
Dockerfile 0.5%