← ClaudeAtlas

charm-tuilisted

Write and review Charmbracelet v2 terminal UIs in Go: Bubble Tea programs, Bubbles components, Lip Gloss styling and layout, Huh forms, Glamour markdown, fang CLI entry, and TUI testing.
xobotyi/cc-foundry · ★ 23 · Web & Frontend · score 84
Install: claude install-skill xobotyi/cc-foundry
The Charm v2 stack is a different library from v1 behind the same names. Three biases decide most calls: - **The module source outranks a remembered API shape.** Training data is saturated with v1, and a v1 idiom either fails to compile against v2 or misbehaves silently. Read `go.mod`, then the module itself, before reaching for a signature. - **The View declares the terminal.** Every terminal feature is a field set on every render, never a program option and never a command. - **`Update` is the only place state changes.** A command does its work on another goroutine and returns a message; `Update` applies it. ## Modules - **`charm.land/<name>/v2`** — bubbletea, bubbles, lipgloss, huh, glamour, fang, log, wish. - **`github.com/charmbracelet/...`** — ultraviolet, colorprofile, and every `x/...` package (`x/ansi`, `x/term`, `x/editor`, `x/exp/golden`, `x/exp/teatest/v2`, `x/exp/charmtone`). - **`github.com/charmbracelet/bubbletea` and its siblings resolve to v1** — never import them. `charm.land/x/ansi` and `charm.land/ultraviolet` do not resolve at all. - **The build error `module declares its path as charm.land/... but was required as github.com/charmbracelet/...` names a stale import.** Fix the import, then run `go mod tidy`. ## The Program - **`View()` returns `tea.View`, a struct.** Build it with `tea.NewView(content)`. The interface is `Init() Cmd`, `Update(Msg) (Model, Cmd)`, `View() View`. - **Terminal features are `tea.View` fields** — `AltScreen`, `