Bienvenue!
Report Bug

Table of Contents

About | Screenshots | Playoffs | Built With | Local Project Setup | AI Agents | Clone the repo | Contact

About

Find the scores and stats of your favorite NBA team! Scorez, boxscores, and playoff data go back to the 1946/47 season.

Screenshots

Scorez App	Boxscore
Playoffz	Series Detail

Playoffs

Navigate to the Playoffs page to explore interactive bracket visualizations.

• Select any season with the year picker
• Toggle results round by round to avoid spoilers
• Click any series to see a game-by-game breakdown with scores, dates, and links to box scores
• Watch links are available for seasons from 2012/13 onward, depending on League Pass availability
• On desktop, the bracket is rendered with React Flow

Back to Top

Built With

Local Project Setup

Git, Node.js, Python, and PNPM (or your package manager of choice) are required to run this project locally.

AI Agents

AI coding agents from OpenAI and Anthropic assisted in writing code throughout this project.

Clone the repo

Copy this and run it in your terminal:

git clone https://github.com/AlexVCS/nba-scores.git
cd nba-scores
pnpm i

Run the frontend by running pnpm dev in one terminal.

To run the backend, open a terminal and run this:

source server/venv/bin/activate
uvicorn server.main:app --reload

Contact

Alex Curtis-Slep - GitHub / Bluesky / alexcurtisslep@gmail.com

Back to Top