💅 Lacquer

Style definitions for gorgeous terminal layouts in Rust.

Features • Installation • Quick Start • Documentation • Ecosystem

What is Lacquer?

Lacquer is the Rust equivalent of lipgloss from Charmbracelet. It provides declarative style definitions for building beautiful terminal layouts—with padding, margins, borders, colors, and alignment.

use lacquer::{Style, Border, Position, Color};

let style = Style::new()
    .padding(1, 2)
    .margin(1, 0)
    .border(Border::Rounded)
    .border_foreground(Color::from_hex("#7C3AED"))
    .foreground(Color::from_hex("#FAFAFA"))
    .bold()
    .align(Position::Center);

println!("{}", style.render("🔥 Molten Labs"));

╭────────────────────╮
│                    │
│   🔥 Molten Labs   │
│                    │
╰────────────────────╯

Features

Installation

cargo add lacquer

Or add to your Cargo.toml:

[dependencies]
lacquer = "0.1"

Quick Start

Basic Styling

use lacquer::{Style, Color};

// Simple colored text
let styled = Style::new()
    .foreground(Color::from_hex("#F97316"))
    .bold()
    .render("Hello, Lacquer!");

println!("{}", styled);

Box with Padding

use lacquer::{Style, Border};

let box_style = Style::new()
    .padding(1, 3)          // 1 vertical, 3 horizontal
    .border(Border::Rounded)
    .render("Content");

println!("{}", box_style);
// ╭─────────────╮
// │             │
// │   Content   │
// │             │
// ╰─────────────╯

Centered Content

use lacquer::{Style, Border, Position};

let centered = Style::new()
    .width(30)
    .border(Border::Double)
    .align(Position::Center)
    .render("Centered!");

println!("{}", centered);
// ╔════════════════════════════╗
// ║          Centered!         ║
// ╚════════════════════════════╝

Multiple Lines

use lacquer::{Style, Border, Color};

let content = "Line 1\nLine 2\nLine 3";

let multiline = Style::new()
    .padding(1, 2)
    .border(Border::Thick)
    .foreground(Color::Green)
    .render(content);

println!("{}", multiline);

Border Styles

use lacquer::Border;

Border::None      // No border
Border::Normal    // ┌──┐ │ └──┘
Border::Rounded   // ╭──╮ │ ╰──╯
Border::Thick     // ┏━━┓ ┃ ┗━━┛
Border::Double    // ╔══╗ ║ ╚══╝
Border::Ascii     // +--+ | +--+
Border::Block     // ████ █ ████
Border::Dashed    // ┌╌╌┐ ╎ └╌╌┘

Custom Borders

use lacquer::{Border, BorderStyle};

let custom = Border::Custom(BorderStyle::new(
    '╭', '─', '╮',  // top-left, top, top-right
    '│',            // right
    '╯', '─', '╰',  // bottom-right, bottom, bottom-left
    '│',            // left
));

Inline Mode

For styling without block rendering (no borders, no padding):

use lacquer::{Style, Color};

let inline = Style::new()
    .foreground(Color::Red)
    .bold()
    .inline()
    .render("Error!");

println!("Status: {}", inline);
// Status: Error! (styled red and bold)

Using with Molten Brand

Enable the brand feature for pre-defined colors:

[dependencies]
lacquer = { version = "0.1", features = ["brand"] }

use lacquer::{Style, Border};
use molten_brand::{colors, products};

let goblin_box = Style::new()
    .border(Border::Rounded)
    .border_foreground(products::lair::PRIMARY.into())
    .foreground(colors::text::PRIMARY.into())
    .render("Lair Terminal");

Why "Lacquer"?

In the forge, lacquer is the hard, protective finish applied to metalwork—transforming raw iron into polished, beautiful artifacts. This library does the same for your terminal output. 💅

Ecosystem

Lacquer is part of the Molten Labs open source ecosystem:

Documentation

• 📖 API Documentation
• 💡 Examples
• 🎨 Molten Brand Colors

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

git clone https://github.com/moltenlabs/lacquer
cd lacquer
cargo test

License

Licensed under either of:

• Apache License, Version 2.0 (LICENSE-APACHE)
• MIT license (LICENSE-MIT)

at your option.

_{Built with 💅 by Molten Labs}

_{"Let them cook."}