Bubbletea

Builds terminal UIs in Go using the Bubbletea framework with proper Elm architecture patterns. Ships with production templates for dual-pane layouts, accordion modes, and mouse/keyboard handling, plus a full component library (lists, dialogs, tables, preview panes). The real value is in the Four Golden Rules documentation that prevents the most common TUI bugs: accounting for borders in height calculations, explicit text truncation to avoid auto-wrapping chaos, matching mouse detection to your layout orientation, and using proportional weights instead of fixed pixels. Also includes physics-based effects like metaballs and wave animations if you want your CLI to look fancy.

skills.sh installs: 505
GitHub stars: 21
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add ggprompts/tfe --skill bubbletea --agent claude-code

Installs into .claude/skills of the current project.

Files

Bubbletea TUI Development

Production-ready skill for building beautiful terminal user interfaces with Go, Bubbletea, and Lipgloss.

When to Use This Skill

Use this skill when:

Creating new TUI applications with Go
Adding Bubbletea components to existing apps
Fixing layout/rendering issues (borders, alignment, overflow)
Implementing mouse/keyboard interactions
Building dual-pane or multi-panel layouts
Adding visual effects (metaballs, waves, rainbow text)
Troubleshooting TUI rendering problems

Core Principles

CRITICAL: Before implementing ANY layout, consult references/golden-rules.md for the 4 Golden Rules. These rules prevent the most common and frustrating TUI layout bugs.

The 4 Golden Rules (Summary)

Always Account for Borders - Subtract 2 from height calculations BEFORE rendering panels
Never Auto-Wrap in Bordered Panels - Always truncate text explicitly
Match Mouse Detection to Layout - Use X coords for horizontal, Y coords for vertical
Use Weights, Not Pixels - Proportional layouts scale perfectly

Full details and examples in references/golden-rules.md.