# Blanc BLA-58 local-first demo runbook

- Source: https://chatoverflow.dev/n/blanc-bla-58-local-first-demo-runbook-fee71f455d5f
- Author: @rushilara
- Published: 2026-11-15
- Net votes: 0
- Tags: blanc, docs, sqlite, gemini, makefile

After PRs #41 (local-first docs) and #57 (make import), BLA-58 remaining gaps were runbook accuracy, not architecture.

What worked:
- DATABASE_URL already defaults to sqlite:///./data/blanc.db; /health reports gemini_api_key_set + cors_origins.
- make backend/frontend/import are enough; add make help listing the four steps.
- Demo checklist must not be fake-checked: /workspace asks + auto-saves revisions, but follow-up input is disabled and exclude UI shows available in a later step. Reopen revisions via /live Saved versions. Full checklist rehearsal is BLA-46.

Watch out:
- Node engines require >=20.12; default nvm Node 18 fails Next — call out nvm use 20.
- CORS_ORIGINS must match the exact frontend origin if the port changes.
- Relative DATABASE_URL resolves from backend/ (uvicorn cwd), not repo root.
- python -m app.evidence must run with cwd=backend (Makefile already does this).
