charmbracelet/bubbles
Bubbles
Bubbles is a terminal user interface toolkit and component library providing a set of pre-built, reusable widgets for creating interactive command-line applications. It functions as a framework for building complex tools that require real-time updates and keyboard navigation.
The library includes a variety of specialized interface elements such as fuzzy-filterable item lists, single-line and multi-line text inputs, and tabular data grids. It also provides visual feedback components including animated loading spinners, progress meters, countdown timers, and stopwatches.
Additional capabilities cover navigation and layout through scrollable content viewports, file picker interfaces, and pagination systems. The toolkit also includes a system for generating dynamic help views based on defined keyboard bindings.
Features
- Terminal User Interface Frameworks - Serves as a comprehensive framework for building interactive, keyboard-driven terminal user interfaces.
- Terminal Widget Toolkits - Offers a collection of pre-built UI widgets for constructing complex, keyboard-navigable terminal applications.
- Model-View-Update Runtimes - Uses a unidirectional data flow pattern to update state and trigger UI redraws based on user input.
- Keyboard Shortcuts - Includes a system for mapping physical keys to software actions and allowing user redefinition of controls.
- State-Driven UI Rendering - Generates terminal output by transforming the current state model into a string representation for every frame update.
- Interactive CLI Frameworks - Provides a toolkit for building complex terminal interfaces with advanced input handling and layout management.
- Application Action Mappings - Maps keyboard events to internal software actions for efficient control of the terminal interface.
- TUI Component Libraries - Provides a reusable library of interactive widgets for building terminal user interfaces.
- UI Composition - Implements an architecture for assembling terminal interfaces from independent, reusable UI components.
- Fuzzy-Filterable Lists - Provides a navigable list component featuring fuzzy filtering and pagination to locate items quickly.
- Fuzzy Matching - Provides fuzzy-matching algorithms to calculate string similarity for filtering list items.
- Interactive CLI Prompts - Provides interactive prompts and text input fields for capturing user data within the terminal.
- Keyboard Shortcut Managers - Maps user input combinations to application-specific actions and generates dynamic help menus.
- Picker Interfaces - Implements an interactive file picker for navigating directories and selecting files in the terminal.
- Terminal Viewport Clipping - Renders only a subset of larger content by calculating a visible window offset and cropping the output.
- Data Grids - Ships an interactive tabular data grid for displaying and navigating structured data in the terminal.
- Terminal Widget Sets - Ships a variety of visual controls like progress bars, spinners, and timers for character-based interfaces.
- TUI - Provides file pickers, paginated lists, and scrollable viewports for browsing datasets in the terminal.
- Plain Text Input Fields - Provides a single-line text input field with support for unicode and horizontal scrolling.
- Multiline Text Areas - Includes a multi-line text area component supporting vertical scrolling and unicode characters for long-form input.
- Scrollable Containers - Implements scrollable containers that allow users to navigate content exceeding the terminal viewport.
- Selectable Lists - Provides interactive vertical lists that support selection, focus, and custom visual styling.
- Terminal Data Visualizations - Renders tabular data, progress meters, and loading indicators using text-based graphics.
- Command Line Tools - TUI components for terminal apps.
- Console Interfaces - Listed in the “Console Interfaces” section of the Awesome Go awesome list.
- Terminal User Interfaces - TUI components for terminal applications.
