bubbletea

SKILL.md

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.

Installs
4
First Seen
Mar 10, 2026