BlitzBoard

BlitzBoard is a pipeline-driven NFL fantasy war room: player intelligence, draft assistance (live + offline), trade and waiver optimization, and real-time news-sentiment trending. Next.js 15 (App Router) + Supabase (Postgres) + a Python cron pipeline. Production: blitzboard.an9.dev.

Status: v3 shipped. v1 (P0–P7) is frozen as v1.0.0 under docs/archive/v1/. v2 (the high-end, accessible, secure, multi-user revamp) shipped through v2.7.0. v3 (Supabase Auth + TOTP, VORP/Monte Carlo models, full page suite, SEO/perf polish) landed on main. See docs/overview/VISION.md and docs/phases/v2/PHASES_OVERVIEW.md.

Documentation map

Area	Where
Vision (v2)	docs/overview/VISION.md
Decisions (v2 ADRs)	docs/decisions/DECISIONS_V2.md
Architecture	docs/architecture/ARCHITECTURE.md · DATA_TRANSFER.md
Design system	DESIGN_GUIDELINE.md · TOKENS · ACCESSIBILITY · MOTION
Modeling	SCORING.md · VALUE_ENGINE.md · DRAFT_LOGIC.md
Security	SECURITY.md · MULTI_LEAGUE.md
Phases (v2)	docs/phases/v2/ — v2.0 … v2.7, full detail
Workflow	VERSIONING · GIT_WORKFLOW · DEFINITION_OF_DONE
Brainstorming	docs/brainstorming/v2-ideas.md
Design research	mocks/v2-research/findings.md — teardown of 12 reference sites
v1 archive	docs/archive/v1/ — frozen v1.0.0 record
Contributing / AI dev	CONTRIBUTING.md · CLAUDE.md

What v2 delivers

Homepage + Players revamp · honest scoring (kickers/defenses no longer overvalued) · draft logic redone and backtested on 2021–2025 · Google/email accounts with an encrypted ESPN/Sleeper credential vault and per-user isolation · multi-league with rules import · public waivers/trades for anyone · a real design system that works beautifully on every screen and is accessible by construction.

Running it

# Frontend (builds & runs with no backend — renders empty states)
cd frontend && npm install
cp .env.local.example .env.local   # add Supabase URL + anon key when ready
npm run dev                        # http://localhost:3000

# Pipeline
cd pipeline && python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env               # add keys when ready

Stack

Next.js 15 (App Router), Tailwind, Framer Motion + Rive + GSAP/Lenis for motion · Supabase (Postgres, RLS) + Supabase Auth (email + TOTP) for accounts · Python 3.11 pipeline on GitHub Actions cron · Vercel hosting + CDN-cached data snapshots.

Workflow at a glance

Versioning is v[phase].[segment].[task]. A phase is a branch; a segment is a sub-branch (build→test→QA→/code-review→commit→push to parent); a phase finishes with an 8-step ritual ending in merge-to-main, tag, doc archival, and a brainstorming file. Never commit to main directly. Details in CONTRIBUTING.md.