skills.rest
devantler-tech
devantler-techOFFICIAL
Explore all skills by this author →
WebsiteGitHub

bubbletea

Build Bubbletea terminal user interfaces with border-aware panels and layouts.

3|1|Updated Apr 17, 2026
Search Tags:#debugging#layout#components#go#tui#bubbletea#lipgloss
One-click install
npx skills add https://github.com/devantler-tech/skills --skill bubbletea-devantler-tech
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bubbletea
Source: https://github.com/devantler-tech/skills/tree/main/bubbletea
Command: npx skills add https://github.com/devantler-tech/skills --skill bubbletea-devantler-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Many Go terminal interfaces suffer from misaligned layouts, mouse/keyboard handling bugs, emoji width inconsistencies, and brittle component composition; this skill provides battle-tested patterns, templates, and reference material to avoid those pitfalls and ship reliable TUIs.

Core Features & Use Cases

  • Production-ready project template: Minimal main entry, separated model/update/view files, and configuration patterns for hot-reloadable YAML settings.
  • Robust layout system: Weight-based sizing, border-aware height accounting, explicit text truncation to prevent wrapping, and clear mouse-coordinate handling for horizontal vs vertical stacks.
  • Comprehensive components & effects: Panels, lists, inputs, dialogs, command palette, previews, interactive tables, and animation effects useful for file browsers, preview panes, and editor-like tools.
  • Debugging and compatibility guidance: Troubleshooting decision trees, emoji width fixes, terminal detection strategies, and performance recommendations for production-grade TUIs.

Quick Start

Scaffold a new Bubbletea Go TUI using the provided template with dual-pane layout, keyboard and mouse handlers, and Lipgloss styling.

Frequently Asked Questions about bubbletea

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a Go terminal UI with dual-pane layouts and mouse support?▼

Build Go terminal UIs using Bubbletea to create dual-pane layouts with keyboard and mouse support. Apply weight-based sizing and border-aware panel composition to prevent misaligned terminal interfaces.

Why does my Go TUI layout break with misaligned borders and text wrapping?▼

Go TUI layouts break due to unhandled border heights and implicit text wrapping. Apply explicit text truncation and border-aware height accounting using Bubbletea patterns to ensure predictable panel alignment and prevent rendering bugs.

How do I handle emoji width compensation in a Go terminal application?▼

Handle emoji width compensation in Go terminal applications by applying Bubbletea debugging patterns and troubleshooting decision trees. These strategies fix alignment inconsistencies caused by variable-width emoji rendering in terminal interfaces.

What is the best way to structure a Go TUI project for lazy-loaded components?▼

Structure Go TUI projects for lazy-loaded components by separating model, update, and view files. Use a minimal main entry point and hot-reloadable YAML configuration patterns to maintain robust component composition.

Does Lipgloss work with Bubbletea for styling interactive tables and command palettes?▼

Lipgloss works with Bubbletea to style interactive tables, command palettes, and preview panes. Integrate these charmbracelet libraries to apply visual effects and consistent styling across complex terminal components.

Can I create tabbed interfaces and dialogs in a Go terminal application?▼

Create tabbed interfaces and dialogs in Go terminal applications using Bubbletea components. The framework supports multi-panel, preview-driven layouts with interactive elements like command palettes and animation effects.

Related Skills

Explore More Software Engineering Skills→
Pabloprogramador23Pabloprogramador23

reversa-scout

Map legacy project folders, languages, frameworks, dependencies, and entry points.

Community
Intermediate
GGPromptsGGPrompts
6

bubbletea

Build Go terminal user interfaces with Bubble Tea and Lipgloss styling.

Community
Advanced
existential-birdsexistential-birds
75

bubbletea-code-review

Review BubbleTea terminal UI code for Elm-architecture and Lipgloss styling conformance.

Official
Intermediate
JBonfimJBonfim

tui-design

Designs keyboard-first terminal user interfaces with layouts, colors, and responsive behavior.

Community
Advanced