Onboarding Runbook¶

First-Time Setup¶

Install prerequisites: git, Docker Desktop, Mise, 1Password CLI (op), and the 1Password desktop app.
Clone repository.
Trust and install the repo-managed Mise tools:

mise trust
mise install

Run mise run init.
Run mise run up.
Open UI URLs from startup output.

Bootstrap Path¶

flowchart LR Install[Install tools] --> Clone[Clone bf-dev] Clone --> Mise[Trust and install Mise tools] Mise --> Init[Run init] Init --> Up[Run up] Up --> Verify[Open local apps]

Expected Outcomes¶

All repos listed in projects.txt are present
Root .env and Docker env/*.env files generated
Host tools from mise.toml are available through Mise
Compose stack starts in selected mode

What Next¶

Once your environment is running:

Open the BetterFleet Knowledge Base
Find and read Ways of Working and the Product Engineering Workflow
Open the relevant Linear issue or project for the work you are actually doing