Should I keep or strip ANSI escape codes in my tests?

The strategy recommends stripping ANSI codes for layout and structural verification to keep tests readable, while preserving them specifically for testing syntax highlighting logic.

How does this skill help test asynchronous Bubbletea operations?

It introduces a 'synchronous execution' pattern where commands are manually called and their resulting messages are applied to the model, removing non-determinism from tests.

Can I test how my TUI looks on different screen sizes?

Yes, the skill includes patterns for using WindowSizeMsg to simulate various terminal dimensions and verify that your components reflow correctly.

What is the primary benefit of golden file testing in a TUI?

Golden files act as a visual 'source of truth,' allowing you to catch unintended layout or color changes by comparing the current rendered output against a previously saved snapshot.

TUI Testing Strategies for Bubbletea

Name: TUI Testing Strategies for Bubbletea
Author: colonyops

bycolonyops

•

セキュリティとテスト

Implements advanced testing patterns for Bubbletea v2 terminal applications including visual regression and component state validation.

This skill provides comprehensive guidance and implementation patterns for testing complex Terminal User Interfaces (TUIs) built with Go's Bubbletea v2 framework. It establishes a layered testing strategy that covers pure logic unit tests, component-level state transitions, visual regression via golden files, and robust handling of asynchronous operations. By utilizing this skill, developers can ensure UI stability, verify correct rendering across different terminal dimensions, and safely mock external tool integrations like syntax highlighters and system editors.

主な機能

01Synchronous helper patterns for testing asynchronous TUI operations

0215 GitHub stars

03Mocking strategies for external CLI tool integrations and editor launches

04Layered testing architecture including Unit, Component, and Golden File tests

05Visual regression testing patterns for complex terminal layouts

06ANSI-aware utilities for stripping or preserving terminal styling in tests

ユースケース

01Testing interactive components like file trees and diff viewers without manual input

02Protecting against visual regressions in terminal UI layouts during refactoring

03Verifying complex viewport scrolling and cursor navigation logic in CLI tools

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add colonyops/hive tui-testing

For use in Claude.ai and ChatGPT

Download Skill