How charmbracelet/bubbles works
Bubbles is a Go library of reusable Bubble Tea terminal UI primitives, rather than a standalone application. A consuming application supplies state and messages to a component, handles its updates, and displays the rendered view. The graph preserves the README’s input, browsing, navigation, feedback, timing, and help capabilities, with selected internal composition shown where the source index or excerpts support it. Relationships involving unsampled components are limited to documented capabilities; no application-level orchestration is inferred.
Main entry points: list.go List browser · textarea.go Text area · help.go Help view · tree.go Tree view
Components 20
Text input
- Text input
textinput/textinput.go - Text area
textarea/textarea.go - Cursor
cursor/cursor.go
Browsing and navigation
- List browser
list/list.go - List delegate
list/defaultitem.go - File picker
filepicker/filepicker.go - Table
table/table.go - Tree view
tree/tree.go - Tree node
tree/node.go - Viewport
viewport/viewport.go - Paginator
paginator/paginator.go
Feedback and timing
- Progress meter
progress/progress.go - Spinner
spinner/spinner.go - Countdown timer
timer/timer.go - Stopwatch
stopwatch/stopwatch.go
Shared UI support
- Help view
help/help.go - Key bindings
key/key.go - Memoization
internal/memoization/memoization.go - Rune utilities
internal/runeutil/runeutil.go
Other components
- Bubble Tea app
Connections 32
- Bubble Tea app → Text input: uses input
README.md - Bubble Tea app → Text area: uses input
README.md - Bubble Tea app → List browser: uses browser
README.md - Bubble Tea app → File picker: uses picker
README.md - Bubble Tea app → Table: uses table
README.md - Bubble Tea app → Tree view: uses tree
README.md - Bubble Tea app → Viewport: uses viewport
README.md - Bubble Tea app → Paginator: uses pagination
README.md - Bubble Tea app → Progress meter: uses progress
README.md - Bubble Tea app → Spinner: uses spinner
README.md - Bubble Tea app → Countdown timer: uses timer
README.md - Bubble Tea app → Stopwatch: uses stopwatch
README.md - Bubble Tea app → Help view: uses help
README.md - Bubble Tea app → Key bindings: configures keys
README.md - Text input → Cursor: uses cursor
textinput/textinput.go - Text input → Rune utilities: uses utilities
textinput/textinput.go - Text area → Cursor: creates cursor
textarea/textarea.go - Text area → Viewport: sets content
textarea/textarea.go - Text area → Memoization: caches wraps
textarea/textarea.go - Text area → Rune utilities: uses utilities
textarea/textarea.go - List browser → Spinner: creates spinner
list/list.go - List browser → Text input: creates filter
list/list.go - List browser → Paginator: renders pages
list/list.go - List browser → Help view: builds help
list/list.go - List browser → List delegate: uses delegate
list/defaultitem.go - File picker → Key bindings: matches keys
filepicker/filepicker.go - Table → Viewport: renders rows
table/table.go - Table → Help view: creates help
table/table.go - Tree view → Tree node: operates on nodes
tree/tree.go - Tree view → Viewport: uses viewport
tree/tree.go - Tree view → Help view: creates help
tree/tree.go - Help view → Key bindings: renders bindings
help/help.go