bubbletealisted

# 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) 1. **Always Account for Borders** - Subtract 2 from height calculations BEFORE rendering panels 2. **Never Auto-Wrap in Bordered Panels** - Always truncate text explicitly 3. **Match Mouse Detection to Layout** - Use X coords for horizontal, Y coords for vertical 4. **Use Weights, Not Pixels** - Proportional layouts scale perfectly Full details and examples in `references/golden-rules.md`. ## Creating New Projects This project includes a production-ready template system. When this skill is bundled with a new project (via `new_project.sh`), use the existing template structure as the starting point. ### Project Structure All new projects follow this architecture: ``` your-app/ ├── main.go # Entry point (minimal, ~21 lines