$ show charmbracelet/bubbles
Bubbles is a Go library providing a collection of reusable, well-crafted UI components (widgets) for building terminal applications with Bubble Tea. Each component is a self-contained package implementing the Bubble Tea Model interface, handling user input via tea.Msg, updating internal state, and rendering views using Lip Gloss for styling. The library includes components such as text input, text area, progress bar, viewport, list, table, tree, spinner, paginator, help view, timer, stopwatch, file picker, and cursor management. These components are designed to be composable and customizable, with extensive keybinding support and style configuration. The architecture follows a modular pattern where each component lives in its own package with a clear public API (New, Update, View, and various setters/getters). Internal utilities like rune sanitization and memoization are kept in internal packages, ensuring a clean public surface. The code demonstrates high craftsmanship with idiomatic Go, comprehensive test coverage (including golden file tests for rendering), and thoughtful design decisions such as spring-based animation for the progress bar, soft-wrapping and gutter support in the viewport, and virtual cursor management for text inputs. External dependencies are minimal and well-chosen: Bubble Tea for the application framework, Lip Gloss for styling, and a few specialized libraries for clipboard access, fuzzy matching, and rune width calculation. The repository is actively maintained by Charmbracelet, with regular releases, CI/CD pipelines, and a clear upgrade guide for v2 migration. It is widely used in production applications like Glow and Charm.
The LLM identified 4 files worth highlighting for reuse:
Implements an animated progress bar with spring physics for smooth transitions, support for solid fills, color blending (gradients), and dynamic per-cell coloring via ColorFunc. It is fully self-contained, uses the harmonica library for spring animation, and provides a clean API with options like WithColors, WithColorFunc, WithScaled, and WithoutPercentage. The component can be extracted and reused in any Bubble Tea application with minimal modification.
A scrollable viewport component that supports vertical and horizontal scrolling, soft-wrapping of text, a left gutter for line numbers or indicators, and highlight ranges with navigation. It handles mouse wheel events, provides methods like SetContent, SetHighlights, and GotoTop/GotoBottom, and integrates with Lip Gloss for styling. The implementation is robust, with careful handling of ANSI escape sequences, double-width characters, and edge cases like empty content or zero dimensions. It is a standalone component that can be reused in any terminal application needing a pager or scrollable area.
Provides a virtual cursor model with configurable blink speed, mode (blink, static, hide), and styling. It manages blink timing using context cancellation and unique IDs to prevent race conditions. The component is small, self-contained, and demonstrates careful handling of concurrent blink messages. It is used internally by textinput and textarea but can be extracted for any component needing a blinking cursor.
Defines a key binding system with support for multiple keys per binding, help text, enable/disable, and unbinding. The Matches function allows checking key presses against bindings. This package is a foundational utility used by all other components and can be reused independently to manage key mappings and generate help views in any Bubble Tea application.