Elaris.UI

Elaris.UI is a lightweight Terminal UI library for .NET that brings modern, beautiful interfaces to the command line. Built with true 24-bit RGB color support and a clean, extensible widget-based architecture.

Features

True 24-bit RGB Color

Full truecolor support via ANSI escape sequences for vibrant, modern terminal applications.

Zero Dependencies

Pure .NET implementation with no external packages required.

Cross-Platform

Works seamlessly on Windows, macOS, and Linux terminals that support ANSI escape codes.

Modern Architecture

Clean, extensible widget-based design that’s easy to learn and extend.

High Performance

Double-buffered rendering with minimal overhead for smooth, responsive UIs.

Multi-Target

Supports .NET 8.0 and .NET 9.0 for maximum compatibility.

Quick Start

Get started with Elaris.UI in just a few steps:

using Ambystech.Elaris.UI;
using Ambystech.Elaris.UI.Widgets.Display;
using Ambystech.Elaris.UI.Widgets.Layout;

var app = new Application();

var frame = new Frame("Hello Elaris!")
{
    BorderStyle = BorderStyle.Rounded,
    ForegroundColor = ColorHelper.FromRgb(100, 200, 255),
};

var label = new Label("Welcome to Elaris CLI UI Library!")
{
    X = 2,
    Y = 2,
    Width = 50,
    Height = 1,
    ForegroundColor = ColorHelper.FromRgb(255, 200, 100),
    Bold = true
};

frame.Add(label);
app.Run(frame);

Next Steps

• Installation - Learn how to install Elaris.UI from NuGet
• Architecture - Understand how Elaris.UI works under the hood
• Widgets - Explore the widget system
• Examples - See Elaris.UI in action

Cross-Platform Compatibility

Elaris.UI is designed to work seamlessly across Windows, macOS, and Linux terminals that support ANSI escape codes. Ensure your terminal supports truecolor for the best experience.

License

MIT License - see LICENSE file for details.