+3
Daily
9,055
stars
486
forks
27
watchers
699
prs
279
issues
38
releases
README
Bubbles Primitives for Bubble Tea applications. These components are used in production in [Crush][crush], and [many other applications][otherstuff]. [!TIP] Upgrading from v1? Check out the upgrade guide, or point your LLM at it and let it go to town. [crush]: https://github.com/charmbracelet/crush [otherstuff]: https://github.com/charmbracelet/bubbletea/bubble-tea-in-the-wild Spinner A spinner, useful for indicating that some kind an operation is happening. There are a couple default ones, but you can also pass your own ”frames.” - Example code, basic spinner - Example code, various spinners Text Input A text input field, akin to an in HTML. Supports unicode, pasting, in-place scrolling when the value exceeds the width of the element and the common, and many customization options. - Example code, one field - Example code, many fields Text Area A text area field, akin to an in HTML. Allows for input that spans multiple lines. Supports unicode, pasting, vertical scrolling when the value exceeds the width and height of the element, and many customization options. - Example code, chat input - Example code, story time input Table A component for displaying and navigating tabular data (columns and rows). Supports vertical scrolling and many customization options. - Example code, countries and populations Progress A simple, customizable progress meter, with optional animation via [Harmonica][harmonica]. Supports solid and gradient fills. The empty and filled runes can be set to whatever you'd like. The percentage readout is customizable and can also be omitted entirely. - Animated example - Static example [harmonica]: https://github.com/charmbracelet/harmonica Paginator A component for handling pagination logic and optionally drawing pagination UI. Supports "dot-style" pagination (similar to what you might see on iOS) and numeric page numbering, but you could also just use this component for the logic and visualize pagination however you like. - Example code Viewport A viewport for vertically scrolling content. Optionally includes standard pager keybindings and mouse wheel support. A high performance mode is available for applications which make use of the alternate screen buffer. - Example code This component is well complemented with [Reflow][reflow] for ANSI-aware indenting and text wrapping. [reflow]: https://github.com/muesli/reflow List A customizable, batteries-included component for browsing a set of items. Features pagination, fuzzy filtering, auto-generated help, an activity spinner, and status messages, all of which can be enabled and disabled as needed. Extrapolated from [Glow][glow]. - Example code, default list - Example code, simple list - Example code, all features File Picker A customizable component for picking a file from the file system. Navigate through directories and select files, optionally limit to certain file extensions. - Example code Timer A simple,
Top issues
#361textinput does not work well with pinyin(Chinese) input method16 comments · 2023-03-27#472Table cell padding no longer works since 1ba120015 comments · 2024-02-02#479Viewport may not scroll down to the end of large text inputs9 comments · 2024-02-09#246Feature request: Style table rows / cells individually8 comments · 2022-09-17#124Filter underline seems to be off8 comments · 2022-03-06#744List Width not respected6 comments · 2025-02-26#190Components do not satisfy tea.Model interface6 comments · 2022-07-07#157feat: add search functionality6 comments · 2022-05-02
Discussions
#1076Optional JSON interaction traces for textinput regressions0 comments · 2026-10-25#1074Optional duration formatter for timer (#128)0 comments · 2026-10-25#1068Bermuda: separate brief progress cards from reusable lessons in a terminal board0 comments · 2026-10-08#975Trouble on list helper background1 comments · 2026-05-16#971textinput/textarea: alias shift+backspace to backspace0 comments · 2026-05-12#961displaying suggestions in a textinput overflows the width2 comments · 2026-04-24#947Fix infinite loop in wordLeft when at buffer start0 comments · 2026-04-11#915(key) Add Equality Assessment Methods0 comments · 2026-03-24
Latest release
v2.2.1 v2.2.1 2026-08-24Tiny Monday bugfix Textarea element had a bug, where you used to be able to go 1 word backwards, even if there was nothing, which resulted in the whole TUI freezing. It was now fixed by @OxQuasar! Changelog Fixed f6134114d735cf40e95c15ff62e7359e46d04fc9: fix(textarea): stop word-left at input boundary (1036) (@OxQuasar) Docs 87d445838781700cb25e3fc3a6b26006eab97b41: docs: update godoc link in readme to new package (@meowgorithm) Other stuff 10489b5fafe92bfaea873297cab8ac8b5c5237f4: readme: drop tree section for now (@meowgorithm) 490948109eb4731927ba2f4cd464d8175a9630d7: v