Getting started

Install Selection Room and launch the web app in under five minutes.

Get the simulator running with sample data. No CFBD API key is required for the first run.

What this page covers

  • Clone and install
  • Run sample data
  • Launch the Next.js web app
  • Where outputs land on disk

1. Install

git clone https://github.com/XavierAgostino/cfp-selection-simulator.git
cd cfp-selection-simulator
make setup

Verify your environment:

sroom doctor

Note

A missing CFBD API key is fine for sample data. Doctor may warn but still pass.

2. Run sample data

make demo

Equivalent:

sroom run --year 2025 --week 15 --sample

3. Launch the web app

From the repo root:

make web

Open the local URL shown in the terminal. The setup wizard walks you through first-run configuration when pipeline data is missing.

4. Inspect outputs

sroom outputs --latest

Artifacts land under data/output/ (rankings, fields, brackets, audits, manifests).

Tip

Prefer the UI? Run make web after make demo and explore Dashboard, Rankings, and Bracket without touching the CLI again.

Introduction

What Selection Room is, who it is for, and how the docs are organized.

Methodology

How Selection Room builds composite rankings and projected CFP fields.

On this page

What this page covers1. Install2. Run sample data3. Launch the web app4. Inspect outputs