Project · Lifebot V2 · Runbooks

Runbook — Local development stack

Run the full zero-knowledge loop locally (encrypt in browser → sync ciphertext → decrypt → dashboard).

type runbookstatus activelifebot · docker · local-dev

Prerequisites

  • Docker + Compose, Node ≥ 20. Repo: ~/Terraform/lifebot-v2.

Steps

  1. docker compose up -d --build — db + redis + api (:8080, AUTH_DEV_BYPASS=1) + worker + web (:5173).
  2. Open http://localhost:5173 → set a master password (creates the vault; no reset exists).
  3. Seed demo data from the dashboard; charts render from client-side decryption.
  4. Storybook for the design system: npm run storybook -w @lifebot/web → :6006.

Verification

  • npm run spike — 8/8 cross-language crypto+sync checks.
  • node --import tsx packages/client/test/integration.ts — client E2E vs the live API.
  • docker compose exec db psql -U postgres -d lifebot -c "SELECT left(ct,40) FROM records LIMIT 3;" → opaque ciphertext only; reload the app with a wrong password → refused.

Rollback

  • docker compose down (add -v to also destroy the data volume — irreversible).
Compiled from wiki/projects/lifebot-v2/runbooks/local-dev.md · git is the source of truth