| name | mft-bootstrap |
| description | Walk a new contributor (or a fresh dev environment) through getting My Family Tree running locally end-to-end. |
Use when the user asks to set up or refresh the local environment.
Steps to run, in order:
- Verify required tools:
docker, uv, yarn, node (>=20), and (optional) pre-commit.
cp .env.example .env if .env doesn't exist; ask the user to fill in
OPENAI_API_KEY and/or ANTHROPIC_API_KEY.
make bootstrap (uv sync + yarn install + pre-commit install).
make up to bring up the docker-compose stack.
- Wait for healthchecks, then
make migrate && make seed.
- Verify:
curl http://localhost:8000/healthz -> 200 with db: ok, s3: ok.
http://localhost:5173/ renders the dashboard.
- If anything fails, run
make logs and surface the failing service.
Don't skip make migrate; the schema doesn't exist until it runs.