resq-tui — Shared TUI Library

A library crate providing standardized themes, layout components, and widgets for all ResQ developer TUIs. Built on top of ratatui and crossterm.

Core Features

• Theme Engine: Unified color palette and styling (Theme).
• Standard Headers/Footers: Consistent brand identity across all explorers.
• Interactive Widgets: Tabs, popups, and centered layouts.
• Formatting Utilities: Human-readable bytes and durations.
• Spinner Support: Standardized loading animations.

Usage (Internal Only)

Add to Cargo.toml:

[dependencies]
resq-tui = { workspace = true }

Rendering a Standard Header

use resq_tui::{self as tui, Theme};

fn draw(f: &mut Frame) {
    let theme = Theme::default();
    tui::draw_header(
        f,
        area,
        "My-Explorer",
        "READY",
        theme.success,
        Some(1234), // PID
        "http://localhost:3000",
        &theme,
    );
}

Rendering a Footer with Shortcuts

tui::draw_footer(
    f,
    area,
    &[("Q", "Quit"), ("Tab", "Focus"), ("↑↓", "Navigate")],
    &theme,
);

Formatting Bytes

use resq_tui::format_bytes;
let size = format_bytes(1024 * 1024 * 5); // "5.0 MiB"

Shared Components