git404hub

what is bubbles fr?

charmbracelet/bubbles — explained in plain English

Analysis updated 2026-06-24

8,353GoAudience · developerComplexity · 2/5Setup · easy

tl;dr

A Go library of ready-made terminal UI components, text inputs, tables, lists, spinners, progress bars, file pickers, and more, for building interactive command-line apps with the Bubble Tea framework.

vibe map

mindmap
  root((Bubbles))
    What it does
      UI components
      Terminal apps
      Go library
    Components
      Text input
      Table and list
      Progress bar
      File picker
    Built on
      Bubble Tea
    Use cases
      CLI tools
      TUI dashboards

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Add a searchable, paginated list picker to a Go CLI tool by dropping in the list component.

VIBE 2

Build a filesystem browser with keyboard navigation inside a terminal app using the file picker component.

VIBE 3

Display a real-time progress bar or spinner while your CLI tool downloads or processes data in the background.

VIBE 4

Show tabular data with scrollable rows and columns in a terminal using the table component.

what's the stack?

GoBubble Tea

how it stacks up fr

charmbracelet/bubbleshavocframework/havocandlabs/ui
Stars8,3538,3528,359
LanguageGoGoGo
Setup difficultyeasyhardmoderate
Complexity2/54/53/5
Audiencedeveloperops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 30min

in plain english

Bubbles is a collection of ready-made interface components for building text-based applications that run in a terminal. It is built on top of Bubble Tea, a framework for creating interactive terminal programs in Go. If Bubble Tea is the foundation, Bubbles is the library of pre-built parts you assemble into a working app. The components cover common interface needs. There is a text input for single-line typing, a text area for multi-line writing, a table for displaying rows and columns of data, and a list for browsing a set of items with optional filtering and pagination. There are also smaller pieces like a spinner to show that something is loading, a progress bar, a timer, a stopwatch, a paginator for navigating pages of content, a viewport for scrolling through long text, a file picker for navigating the filesystem, and a help view that generates a keyboard shortcut reference automatically from your defined keybindings. Each component is designed to be dropped into a Bubble Tea application as a reusable piece. Developers can customize colors, key bindings, sizes, and other visual properties to match the style of their app. The components handle the rendering and update logic internally, so the developer focuses on how to wire them together rather than how to draw each element from scratch. The project is maintained by Charmbracelet, the same team behind Bubble Tea and other terminal tooling. The components are used in production in Charmbracelet's own applications and in many community projects. There is also a collection of community-maintained components beyond what this repository includes.

prompts (copy fr)

prompt 1
Write a Bubble Tea app in Go that uses the bubbles list component to display a menu of 10 options with vim-style keyboard navigation and fuzzy filtering.
prompt 2
Show me how to combine the bubbles text input and viewport components to build a terminal chat interface in Go where the input stays at the bottom.
prompt 3
Using charmbracelet/bubbles, add a file picker component to my existing Bubble Tea app so users can select a config file at startup.
prompt 4
Create a Go terminal app with a bubbles progress bar that fills as a background goroutine completes work, updating every 100ms.

Frequently asked questions

what is bubbles fr?

A Go library of ready-made terminal UI components, text inputs, tables, lists, spinners, progress bars, file pickers, and more, for building interactive command-line apps with the Bubble Tea framework.

What language is bubbles written in?

Mainly Go. The stack also includes Go, Bubble Tea.

How hard is bubbles to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is bubbles for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.