CFL Manager

A local data store and analysis API for the Competelevel Fantasy League on Fantrax: an 11-team dynasty league with an auction draft and H2H "each category" scoring.

It pulls league structure, rosters, schedules and weekly category results from Fantrax, and player stats from NHL.com. Everything goes into a single SQLite file, or a Postgres database when the app is deployed (see Deploying to Vercel). The analysis layer projects every player, profiles every team by category, and ranks waiver and trade targets by what your team needs.

Setup

python3 -m venv .venv
.venv/bin/pip install -r requirements-dev.txt
cp .env.example .env            # then set FANTRAX_MY_TEAM_ID (your team, for the CLI and local use)
.venv/bin/python -m cfl sync    # ~2s, writes data/league.db
.venv/bin/python -m cfl teams   # find your team id for .env
(cd frontend && npm ci && npm run build)   # the web app, into cfl/web/dist (Node 24)
.venv/bin/python -m cfl serve   # app at http://127.0.0.1:8000, API docs at /docs

Web app

python -m cfl serve (add --reload while developing) serves the app at http://127.0.0.1:8000. The page's source is in frontend/. Vite builds it into cfl/web/dist/, which FastAPI serves. Without a build, the API and the CLI work, but / returns an error.

To work on the page, run the API and Vite's dev server side by side:

.venv/bin/python -m cfl serve --reload   # the API, on port 8000
cd frontend && npm run dev               # the page at http://localhost:5173, updated as you edit

Vite sends the API's paths to port 8000. It reads them from frontend/openapi.json, so after you change an endpoint, run npm run api in frontend/. It also regenerates the typed client, src/api/generated.ts. A test fails until you do.

Before a PR, run npm run check in frontend/ (Biome, TypeScript, then Vitest) and pytest.

• Dashboard. A GM's overview of a team, from real results only (no projections):

  • At a glance: this week's category score and opponent, standings, and roster spots.
  • Categories: this week's head-to-head in each category (your total, the opponent's, won or lost), next to the season's record and league rank in that category. Some weeks bring two opponents, or a bye.
  • Standings from Fantrax. Click a team to see its dashboard.
  • Roster by position: age, this NHL season's games and totals in each league category, salary, years left, and RFA or UFA at expiry. Click a column to sort.

  The team picker in the header lets you view any team. Projections and market values are on the Analysis tab.

• Analysis. The projections behind the trade builder, for the team in the header's picker:

  • Tiles: expected category wins per week against an average opponent, projected strength across the league, and skater games and goalie starts per week from projected daily lineups.
  • Category profile: projected strength in each category against the league average, with projected per-week totals, rank, actual W-L-T and need weight.
  • League at a glance: a heatmap of every team's projected rank in every category.
  • Player values: each player's value, need value, trade rank and market value, games per week and best categories.

This is the beginning of the README. Read the rest at the original. Read the full README ↗