golang-build

Experimental Go build tooling, references, and CI pipeline.

Binaries

• cmd/server — HTTP API on :8080 (gorilla/mux + middleware chain).
• cmd/onboard — interactive TUI wizard that generates a .env for the server.
• cmd/loadgen — TUI HTTP load generator with a live-updating dashboard.
• cmd/scaffold — TUI code generator: pick handler/middleware/package + name → write boilerplate file.
• cmd/admin — TUI for inspecting a deployment: list users, run healthchecks. Falls back to a fake backend when DATABASE_URL is unset.
• cmd/devup — TUI wrapper around docker compose: pick service, pick action, view output. Demonstrates subprocess management via internal/proc.
• cmd/migrate — TUI for inspecting and applying schema migrations. Composes AsyncTask/Picker/Confirm/Done against a Migrator interface; falls back to a FakeMigrator with --fake for demos / CI without a database.
• cmd/inspect — TUI demo that wires internal/eventbus into the LiveView phase: pick a scenario, watch synthetic events flow with live counters, level breakdown, and a rolling tail of the most recent events.

TUI scaffolding

internal/tui/ is a small framework on top of bubbletea/lipgloss for building multi-step terminal wizards from this template. It exposes a Phase interface and four reusable phases:

• Picker — single-select list, optionally rendered as a comparison table.
• Confirm — yes/no prompt with default selection.
• AsyncTask — runs a worker function with a spinner, emits TaskDoneMsg.
• LiveView — polls a LiveSampler on a tick, re-renders each sample, emits LiveDoneMsg when sampler reports done. Used for live dashboards (see cmd/loadgen).
• TextInput — single-line input backed by bubbles/textinput with optional inline validation. Emits TextInputDoneMsg.
• Done — final summary, quits on enter.

Each phase emits a tagged completion message (PickerDoneMsg, ConfirmDoneMsg, TaskDoneMsg); the caller's root tea.Model switches on the tag and transitions to the next phase. See cmd/onboard/model.go for the canonical assembly pattern, and cmd/onboard/headless.go for the non-TTY codepath used in CI.

make build-onboard
./onboard                              # interactive
./onboard --preset standard --yes      # headless, writes .env with defaults