Skip to main content
The Bubble Tea framework comes with a comprehensive collection of examples demonstrating various patterns and components. Each example is a complete, working application that you can run and study.

Getting Started

All examples are available in the examples directory of the Bubble Tea repository. To run any example:
cd examples/<example-name>
go run .

Example Categories

Lists and Selection

Simple List

A minimal list implementation with custom styling

Default List

Using the list bubble with default settings

Fancy List

Advanced list customization with custom delegates

Result Menu

Choice menu with selectable options

Forms and Input

Text Input

Single and multiple text input fields

Text Area

Multi-line text input

ISBN Form

Multi-step form with validation

Split Editors

Multiple text areas with focus management

Loading States

Spinner

Loading indicator with various styles

Progress Bars

Animated and static progress indicators

Stopwatch

Timer-based updates

Mouse Interaction

Mouse Events

Basic mouse event handling

Clickable Elements

Interactive drag-and-drop interface

Layout and Views

Composable Views

Combining multiple models

Multiple Views

Switching between different views

Tabs

Tabbed navigation

Table

Display tabular data

Advanced Patterns

HTTP Requests

Making HTTP calls in your app

Real-time Updates

Using channels for real-time communication

Exec Commands

Launching external commands

Pipe Data

Shell pipe communication

Package Manager

Building a package manager interface

Other Examples

Simple

The simplest possible Bubble Tea app

Pager

Build a less-like pager

Help Menu

Display help information

Alt Screen

Toggle alternative screen buffer

Learning Path

If you’re new to Bubble Tea, we recommend exploring the examples in this order:
  1. Simple - Understand the basic structure
  2. Spinner - Learn about commands and updates
  3. Text Input - Handle user input
  4. Simple List - Work with collections
  5. HTTP - Integrate external data
  6. Composable Views - Build complex applications

Source Code

All examples include complete, runnable source code. Browse the full collection on GitHub.

Build docs developers (and LLMs) love