Installation

Add the NuGet package:

dotnet add package ktsu.TUI

Quick Start

using ktsu.TUI.Core.Services;
using ktsu.TUI.Core.Elements.Primitives;
using ktsu.TUI.Core.Elements.Layouts;
using ktsu.TUI.Core.Models;

// Create console provider
var consoleProvider = new SpectreConsoleProvider();

// Create a simple UI
var ui = new BorderElement
{
    Title = "My TUI App",
    BorderStyle = BorderStyle.Double,
    Child = new TextElement
    {
        Text = "Hello, TUI World!",
        Style = new TextStyle { IsBold = true, Foreground = "green" }
    }
};

// Create and run application
var app = UIApplication.CreateBuilder(consoleProvider)
    .UseRootElement(ui)
    .Build();

await app.RunAsync();

Demo Applications

The library includes several demonstration applications:

• Sample App (default): Advanced demo showcasing architecture and features
• Interactive Demo: Interactive controls and real-time updates (--interactive)
• Showcase Demo: Visual demonstration of all styling features (--showcase)

Run demos:

dotnet run --project TUI.App                    # Sample app
dotnet run --project TUI.App -- --interactive   # Interactive demo
dotnet run --project TUI.App -- --showcase      # Showcase demo

Key Components

UI Elements

• TextElement: Styled text display
• BorderElement: Bordered containers with titles
• StackPanel: Horizontal/vertical layout container

Styling

• TextStyle: Font styling (bold, italic, underline, colors)
• BorderStyle: Border appearance (single, double, rounded, etc.)
• Padding: Space around content
• Position: Element positioning

Input System

• Keyboard input handling
• ESC key to exit applications
• Extensible input event system

Contributing

This project follows clean architecture principles and emphasizes:

• SOLID design principles
• DRY (Don't Repeat Yourself) implementation
• Comprehensive testing
• Clear separation of concerns

License

MIT License. Copyright (c) ktsu.dev