textual-8-2-4

name	textual-8-2-4
description	Python framework for building terminal and browser UIs. Provides widget-based DOM, CSS styling (.tcss), reactive attributes, event system, Workers API for concurrency, command palette, and theming. Use when building terminal UIs, CLI tools with rich interfaces, data dashboards, interactive forms, or any Python application requiring a graphical interface in the terminal.
license	MIT
author	Tangled <[e-mail]>
version	0.1.0
tags	["tui","terminal-ui","python","framework","reactive","widgets","css"]
category	framework
external_references	["https://github.com/Textualize/textual","https://textual.textualize.io/"]

Textual 8.2.4

Overview

Textual is a Rapid Application Development (RAD) framework for Python, built by Textualize.io. It lets you build sophisticated user interfaces with a simple Python API that run in the terminal or a web browser (via textual-serve). Textual runs on Linux, macOS, Windows, and any OS where Python runs — including single-board computers and over SSH.

Key characteristics:

• Widget-based DOM — hierarchical tree of widgets, each managing a rectangular screen region
• CSS styling — .tcss files with selectors, pseudo-classes, and theme variables ($primary, $surface)
• Reactive attributes — auto-refresh on value change, with watch/validate hooks
• Event/message system — asyncio-powered message queues per widget, bubbling, custom messages
• Screen stack — push/pop/switch screens for modal dialogs and navigation
• Workers API — background coroutines and threads with state tracking
• Command palette — built-in Ctrl+P palette for actions and theme switching
• Inline mode — run apps beneath the shell prompt (non-fullscreen)
• Devtools — live CSS editing, console logging via textual run --dev

When to Use

• Building terminal user interfaces (TUIs) with Python
• Creating interactive CLI tools that need buttons, forms, tables, or trees
• Developing data dashboards or monitoring displays in the terminal
• Prototyping UIs rapidly without browser tooling
• Building apps that must run over SSH or on low-resource hardware
• Creating cross-platform terminal apps (Linux, macOS, Windows)

Core Concepts

App and Widgets

Every Textual application starts by subclassing App. Widgets are components that manage portions of the screen. The app composes widgets via a compose() generator method:

from textual.app import App, ComposeResult
from textual.widgets import Header, Footer, Static

class MyApp(App):
     () -> ComposeResult:
         Header()
         Static()
         Footer()

 __name__ == :
    MyApp().run()