Local development
Contributor setup for the Python engine and Next.js web app.
Selection Room is a monorepo: Python analytics under src/, Next.js UI under web/, and shared docs at the repo root.
What this page covers
- Prerequisites
- Python and web dev commands
- Fixture sync for the web app
Prerequisites
- Python 3.11+ with
make setup/pip install -e ".[dev]" - Node via mise or your preferred manager; pnpm for the web app
- Optional: CFBD API key for Live CFBD runs
Common commands
make demo # Sample pipeline run
make web # Next.js dev server (web/)
make test # Python tests
cd web && pnpm buildWeb data sync
The web app reads JSON from data/output/api/. Use fixture seeding scripts documented in the repo when you need a predictable catalog without running the full pipeline.
Tip
Run sroom doctor after environment changes. It catches missing keys and path issues early.