Bubbletea

What it does

This skill enables AI agents to develop terminal user interfaces (TUIs) using Go, Bubbletea, and Lipgloss. It provides a production-ready template system for creating new TUI applications, adding components to existing ones, resolving layout issues, implementing interactions, and incorporating visual effects. The skill emphasizes adherence to "Golden Rules" to prevent common TUI layout bugs.

When to use it

• Creating new TUI applications with Go.
• Adding Bubbletea components to existing applications.
• Fixing layout or rendering problems (e.g., borders, alignment, overflow).
• Implementing mouse and keyboard interactions within a TUI.
• Building complex layouts like dual-pane or multi-panel interfaces.

Key capabilities

• Production-ready template system: Provides a structured starting point for new projects.
• Panel System: Supports single, dual-pane, multi-panel, and tabbed layouts.
• Reusable Components: Includes lists, input fields, dialogs, menus, status bars, previews, and tables.
• Visual Effects Library: Offers metaballs, wave effects, rainbow cycling, and layer compositing.
• Configuration Management: Supports YAML configuration with hot-reload capabilities.
• Adherence to "Golden Rules": A set of guidelines to prevent common TUI layout errors (border accounting, text truncation, mouse detection alignment, proportional layouts).

Example prompts

• "Create a new TUI project using the Bubbletea template."
• "Add a dual-pane layout to my existing application."
• "How do I fix an overflow issue in my TUI panel?"

Tips & gotchas

• Golden Rules are critical: Always consult references/golden-rules.md before implementing any layout. Failing to do so can lead to frustrating bugs.
• File Size Limits: Individual files should ideally be less than 500 lines, with a maximum of 800.
• Project Structure: New projects follow a specific architecture including main.go, types.go, model.go and more – refer to the documentation for details.