Skip to main content

Onboarding a New Developer

Use this checklist to get a new teammate productive on day one without tribal knowledge.

Baseline checklist​

  1. Install binaries:
  • flowlayer-server
  • flowlayer-client-tui
  1. Clone repository and fetch the canonical flowlayer.jsonc.
  2. Run local server once:
flowlayer-server -c ./flowlayer.jsonc
  1. If session mode is enabled, validate health endpoint:
curl -H "Authorization: Bearer <token>" http://127.0.0.1:6999/health
  1. Connect TUI:
flowlayer-client-tui -addr 127.0.0.1:6999 -token <token>

What to teach explicitly​

  • server/client role split
  • session.bind vs session.addr
  • readiness and dependency basics
  • where runtime logs come from

Common onboarding failures​

  • using wrong binary name
  • trying to use server config as TUI config without session.addr
  • expecting FlowLayer to behave like a production orchestrator

Direct references: