tui-banner

Cinematic ANSI banners for Rust CLI/TUI.

Features

• Grid-first rendering pipeline
• Bundled DOS Rebel (Figlet) font + load any .flf
• Truecolor / 256-color / no-color output with auto-detect
• Gradients, pixel fill, dithering, shadows, edge shading
• Named style and palette presets
• Fluent builder API

Quick Start

[dependencies]
tui-banner = "0.1.4"

use tui_banner::{Align, Banner, Style};

fn main() -> Result<(), tui_banner::BannerError> {
    let banner = Banner::new("RUST CLI")?
        .style(Style::NeonCyber)
        .render();

    println!("{banner}");
    Ok(())
}

Custom Example

use tui_banner::{Align, Banner, ColorMode, Fill, Gradient, Palette};

fn main() -> Result<(), tui_banner::BannerError> {
    let banner = Banner::new("RUST CLI")?
        .color_mode(ColorMode::TrueColor)
        .gradient(Gradient::vertical(Palette::from_hex(&[
            "#00E5FF", // cyan
            "#3A7BFF", // blue
            "#E6F6FF", // ice
        ])))
        .fill(Fill::Keep)
        .dither()
        .targets("░▒▓")
        .checker(3)
        .align(Align::Center)
        .padding(1)
        .render();

    println!("{banner}");
    Ok(())
}