bubbletea

Prevent rendering and interaction defects in Bubbletea terminal user interfaces in Go.

Updated May 15, 2026
One-click install
npx skills add https://github.com/JBonfim/skill-developer --skill bubbletea-jbonfim
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bubbletea
Source: https://github.com/JBonfim/skill-developer/tree/main/.agents/skills/bubbletea
Command: npx skills add https://github.com/JBonfim/skill-developer --skill bubbletea-jbonfim

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill solves the most common pain points when building terminal user interfaces—broken borders, misaligned panels, accidental text wrapping, and unreliable mouse interaction—by enforcing battle-tested Bubbletea layout rules.

Core Features & Use Cases

  • Golden-rule layout safety: Prevents classic rendering issues by applying border accounting, explicit truncation (no auto-wrap), mouse coordinate matching (X vs Y), and weight-based panel sizing.
  • Production-ready TUI patterns: Provides a template-oriented structure for dual-pane and multi-panel TUIs, including a reusable component catalog and effects patterns.
  • When to use it: Ideal for Go projects using Bubbletea/Lipgloss where you need dual-pane interfaces, accordion/focus layouts, mouse/keyboard handling, and reliable styling without “jitter” or overflow.

Quick Start

Use the bubbletea skill to implement a dual-pane Bubbletea TUI in Go that correctly truncates text to avoid wrapping and keeps panel borders perfectly aligned.

Frequently Asked Questions about bubbletea

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

FAQPage Schema
How do I fix broken borders and misaligned panels in a Bubbletea TUI?

To fix broken borders and misaligned panels in a Bubbletea TUI, apply border-aware sizing rules and explicit text truncation to prevent auto-wrapping. This ensures terminal user interface layouts render without jitter or overflow.

Why does mouse handling not work correctly in my Go terminal user interface?

Mouse handling fails in Go terminal user interfaces when coordinate matching between X and Y axes is inconsistent. Enforcing layout-consistent mouse coordinate mapping against panel boundaries resolves unreliable click and scroll interactions.

What's the best way to structure a dual-pane layout in Bubbletea and Lipgloss?

The best way to structure a dual-pane layout in Bubbletea and Lipgloss is using weight-based proportional panel dimensions. This approach maintains consistent sizing across terminal resizes and prevents border overlap.

How do I prevent text wrapping issues when rendering Go TUI components?

To prevent text wrapping issues when rendering Go TUI components, apply explicit truncation to all text output before rendering. This stops accidental auto-wrapping from breaking your terminal user interface layout alignment.

Can I use weight-based sizing for multi-panel accordion layouts in Bubbletea?

Yes, you can use weight-based sizing for multi-panel accordion layouts in Bubbletea. It supports accordion focus behaviors and proportional panel dimensions simultaneously, ensuring correct rendering and interaction across expanded and collapsed states.

When do I need explicit truncation rules for Lipgloss styling in Go TUIs?

You need explicit truncation rules for Lipgloss styling in Go TUIs whenever rendering text inside bordered panels. Without it, terminal width changes trigger auto-wrapping, causing layout jitter and breaking visual alignment.