Skip to content
Package87 repository health

Bubbles

Ready-made terminal UI components—spinners, tables, lists, inputs, and more—for building Bubble Tea applications in Go.

Library Govv1.0.09,067 stars MIT License
go get github.com/charmbracelet/bubbles
View source

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Excellent
  • Development activity100
  • Maintenance84
  • Community64
  • Maturity60
  • Momentum40

Technical analysis

AI-assessed by reading the actual repository — architecture, code quality, innovation, and documentation.How we score it →
Good
  • Architecture82
  • Code quality80
  • Innovation83
  • Learning curve45

Bubbles is a collection of common terminal UI components built for Bubble Tea, the Elm-architecture TUI framework from Charm. Instead of hand-rolling spinners, paginated lists, text inputs, file pickers, or scrollable viewports for every new command-line tool, developers import the pieces they need and wire them into their own Bubble Tea Model.

Each component—spinner, textinput, textarea, table, progress, paginator, viewport, list, filepicker, timer, stopwatch, help, key, cursor, and tree—is a self-contained Bubble Tea model with its own Init, Update, and View methods, so they compose the same way a hand-written Bubble Tea program would. The components ship in production inside Charm’s own tools (like Crush) and a wide range of community CLIs, making Bubbles the de facto standard component kit for Go terminal applications.

What You Get

  • A spinner component with several built-in animation styles (Line, Dot, MiniDot, Jump, Pulse, Points, Globe, Moon, Monkey) plus support for custom frame sequences
  • Text input and text area components with unicode support, paste handling, in-place horizontal/vertical scrolling, and extensive styling hooks
  • A batteries-included list component with pagination, fuzzy filtering, an activity spinner, and auto-generated status/help text
  • A table component for rendering and navigating columnar data with vertical scrolling
  • A progress bar with optional physics-based animation (via Harmonica) and solid or gradient fills
  • Paginator, viewport, file picker, timer, stopwatch, help, and tree components covering the remaining common TUI patterns
  • A dedicated key package for declaring user-remappable keybindings that also auto-generate their own help text

Common Use Cases

  • Building developer CLI tools that need a polished interactive experience (progress indicators, selection lists, forms) instead of raw stdin prompts
  • Assembling admin or ops dashboards that run entirely in the terminal, using the table and viewport components to browse data
  • Adding an interactive file or directory picker to a CLI without writing custom filesystem-navigation UI
  • Implementing consistent, remappable keyboard shortcuts across a multi-screen terminal application via the key and help packages

Under The Hood

Architecture

Bubbles is organized as one independent Go package per component (spinner, list, table, textinput, and so on), each implementing the same Elm-style contract Bubble Tea expects: a Model struct plus Init, Update(tea.Msg), and View() methods, so any component drops straight into a parent program’s Update/View without adapters. There is no central registry, dependency injection, or shared mutable state; composition happens by embedding component models as fields on the consumer’s own model and forwarding messages explicitly. A shared key package standardizes keybinding declaration and matching across every component, and the list and help packages depend on lower-level components (paginator, spinner, textinput) directly, showing a clear internal layering from primitives up to composite widgets.

Tech Stack

The module targets Go 1.25 and builds on the charm.land/bubbletea/v2 runtime and charm.land/lipgloss/v2 for styling, both from the same Charm ecosystem. Terminal-specific concerns are handled by small, focused dependencies: github.com/charmbracelet/harmonica for physics-based progress animation, github.com/mattn/go-runewidth and github.com/rivo/uniseg for unicode-aware width and grapheme handling, github.com/sahilm/fuzzy for the list’s fuzzy filtering, and github.com/atotto/clipboard for paste support in text inputs. Releases are cut with GoReleaser and a Taskfile drives local build/lint/test tasks.

Code Quality

The repository has test files alongside roughly half its component packages (spinner, list, key, and others), written as external _test packages that exercise the public API rather than internals—a black-box style that keeps tests honest about what consumers actually see. .golangci.yml configures a strict linter, and GitHub Actions workflows run build, lint, and coverage checks on every push, giving the project consistent CI gating even without exhaustive test coverage across every component.

API Design Every component follows the identical New() / Update(msg) / View() shape, so learning one component (spinner) transfers directly to the next (list, table, textinput)—this consistency is Bubbles’ main developer-experience win over rolling custom terminal widgets. The key package turns keybinding declarations into both matching logic and auto-generated help text in one definition, removing a whole class of boilerplate and drift between what a shortcut does and what the help view says it does. Godoc comments are thorough at the package level, though runnable examples live in the separate bubbletea repository rather than inline, so newcomers need to cross-reference both repos to get started.

Used by 11 apps in this directory

Every app whose dependencies include github.com/charmbracelet/bubbles, nine to a page.

Showing 11 apps
Go 58%Apache 2.0

Authgear

2,158

Authentication

Open-source, self-hostable authentication platform with passkeys, biometric login, SSO, MFA, and GraphQL admin API — a full Auth0/Clerk/Firebase alternative for SaaS and mobile apps.

App
Built with
  • Go 58%
  • HTML 20%
  • TypeScript 19%
Updated yesterdayView details
Go 74%AGPL 3.0

Coder

17,450

Code Editors · Developer Tools · Devops

Self-hosted cloud development environments and AI coding agents — defined in Terraform, connected via WireGuard, automatically shut down when idle.

App
Built with
  • Go 74%
  • TypeScript 24%
Updated todayView details
Go 36%Apache 2.0

CubeSandbox

13,391

AI Agents · Developer Tools · Security

Instant, concurrent, hardware-isolated MicroVM sandboxes for AI agents — E2B-API compatible, sub-60ms cold starts, and a built-in zero-trust egress proxy, all self-hostable at scale.

App
Built with
  • Go 36%
  • Rust 23%
  • C 20%
Updated todayView details
TypeScript 47%AGPL 3.0

Grafana

78,021

Analytics · Monitoring

The open-source observability platform that unifies metrics, logs, and traces from any data source into dynamic, queryable dashboards.

App
Built with
  • TypeScript 47%
  • Go 47%
Updated todayView details
Go 88%MIT

Hatchet

8,325

AI Development · Automation · Developer Tools

A Postgres-backed orchestration engine for background tasks, AI agents, and durable workflows that replaces Redis queues and multi-datastore durable execution platforms with a single self-hostable service.

App
Built with
  • Go 88%
Updated yesterdayView details
Go 99%Apache 2.0

klaw

635

AI Agents · Devops

kubectl for AI Agents — manage, schedule, and scale your AI workforce with a single binary that deploys in seconds.

App
Built with
  • Go 99%
Updated 7 months agoView details
Go 72%Apache 2.0

OSV.dev

3,079

Security

Google's open-source vulnerability database that maps CVEs to exact package versions across 50+ ecosystems with a public API and data dumps.

App
Built with
  • Go 72%
  • Python 18%
Updated yesterdayView details
Go 93%MIT

Plandex

15,924

AI Code Assistants

An open-source, terminal-based AI coding agent built for large tasks and real codebases — with its own version control for plans, a 2M-token effective context window, and self-hosted or cloud deployment.

App
Built with
  • Go 93%
Updated 1 years agoView details
Python 55%Other

PostHog

40,995

Ab Testing Experimentation · Analytics · Developer Tools

The all-in-one open source product platform combining analytics, session replay, feature flags, error tracking, AI observability, and a built-in data warehouse in a single self-hostable stack.

App
Built with
  • Python 55%
  • TypeScript 37%
Updated todayView details

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers