# charmbracelet/bubbles

TUI components for Bubble Tea 🫧

Repository: https://github.com/charmbracelet/bubbles
Canonical: https://ross.abutalabs.com/products/bubbles
Language: Go
License: MIT
License Family: permissive
Topics: elm-architecture, tui, terminal, cli, hacktoberfest
Last push: 2026-08-24T09:14:22+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 87, longevity 100
- inputs: {"age_days": 2419, "days_push": 9, "days_rel": 9, "gap_med": 38.5, "n_releases_24m": 9}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 8841, forks 449 (observed 2026-08-28T04:10:25.986147+00:00)

## What it is
Bubbles is a collection of ready-made TUI components (spinner, text input, textarea, table, and more) for building terminal applications with the Bubble Tea framework in Go. It provides common UI primitives following the Elm architecture so developers can compose rich terminal interfaces quickly.

## Use cases
- build a terminal dashboard with tables and scrolling lists
- add a text input or textarea to a Bubble Tea CLI app
- show a spinner while a long-running task executes in the terminal
- create interactive TUI forms with multiple input fields
- build a chat-like terminal interface with a message input area

## When to choose
- you are building a Go terminal app with Bubble Tea and need common UI components
- you want production-tested TUI primitives instead of writing your own
- you want components that follow the Elm architecture model-update-view pattern

## When to avoid
- you are not using Go or the Bubble Tea framework
- you need a full TUI framework rather than individual components
- you are building a graphical (non-terminal) application

## Facets
- artifact type: library
- maturity: active
- function: ui-components, terminal-ui, cli
- domain: developer-tools, web-development
- platform: go, cli, cross-platform
- tags: tui, bubbletea, elm-architecture, terminal-components, charmbracelet, command-line

## Member repositories
- charmbracelet/bubbles (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:25.986147+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:24:48.591434+00:00, confidence not recorded.
  - readme: https://github.com/charmbracelet/bubbles (fetched 2026-08-28T04:10:25.986147+00:00, sha 84ba3c682e94)
- Data as of 2026-08-30T08:39:29.467469+00:00.