LEARNING.md

Learning Go and Bubble Tea with Rig

This guide teaches Go fundamentals and the Bubble Tea TUI framework using the rig codebase as a living example. Every concept is illustrated with real code from this repo.

Guides

Go Language

1. Go Fundamentals — entry points, value types, zero values, modules, packages, and imports
2. Types, Functions, and Error Handling — structs, interfaces, receivers, closures, slices, init(), and concurrency

Bubble Tea Framework

3. The Elm Architecture — the Model-Update-View loop and the tea.Model interface
4. Messages and Commands — how events flow and async work is triggered
5. Composing Models — parent-child delegation, the standalone wrapper, and embedded components
6. Async Operations — the startAsync pattern, bubbles spinner/stopwatch components, and the error splash overlay

Supporting Tools

7. Styling and CLI — Lipgloss terminal styling and Cobra CLI routing

Practical

8. Testing — test conventions, table-driven tests, and testing Bubble Tea models
9. Gotchas — value semantics bugs, closure capture, nil slices, and other pitfalls
10. Adding a New Tool — step-by-step recipe that ties all the concepts together

Further Reading

• A Tour of Go — official interactive tutorial
• Effective Go — idiomatic Go patterns
• Bubble Tea docs — framework docs and examples
• Lipgloss docs — styling reference
• Cobra docs — CLI framework
• Go by Example — concise examples of Go features