Textual TUI Framework Guide

What problem does it solve?

This Skill provides comprehensive guidance and best practices for developing sophisticated terminal user interfaces (TUIs) using the Textual framework in Python, streamlining development and improving application quality.

Core Features & Use Cases

• Framework Fundamentals: Understand Textual's architecture, app lifecycle, and core components.
• Widget Development: Learn to create custom widgets, handle events (mouse, keyboard), and manage reactive state.
• Styling & Layout: Master Textual CSS (tcss) for visually appealing and responsive terminal interfaces.
• Asynchronous Operations: Implement background tasks using the @work decorator for non-blocking UI.
• Testing & Debugging: Utilize Pilot for automated testing and Textual's debugging tools for efficient troubleshooting.
• Use Case: You are building a real-time collaborative drawing application in the terminal. This Skill will guide you on how to implement drawing interactions using mouse events, manage the ephemeral nature of trails with reactive state, and structure your Textual app for optimal performance.

Quick Start

Use the textual-guide skill to learn how to implement mouse event handling for drawing interactions within a Textual application.