🎨 @omerdev/color-forge

Ultra-lightweight terminal styling and RGB/HEX/HSL color manipulator faster and smaller than chalk/colorette (<1.5KB).

⚡ Why color-forge?

• Zero Dependencies: Tiny footprint (<1.5KB), faster startup than chalk or colorette.
• Fluent & Chainable: Write forge.bold.red("Error!") or use direct functions red("Error").
• TrueColor (24-bit): Full support for custom rgb(r, g, b) and hex("#ff007f") foreground & background styling.
• Color Conversions: Built-in fast converters for hexToRgb, rgbToHex, rgbToHsl, hslToRgb, lighten, and darken.
• Smart Color Detection: Automatically respects NO_COLOR, FORCE_COLOR, and non-TTY streams.

📦 Installation

npm install @omerdev/color-forge
# or
pnpm add @omerdev/color-forge
# or
bun add @omerdev/color-forge

💡 Quick Start

1. Terminal Styling

import forge, { red, green, bold, hex, rgb } from "@omerdev/color-forge";

// Chained styles
console.log(forge.bold.cyan("Server listening on port 3000"));
console.log(forge.bgRed.white.bold(" FATAL ERROR "));

// Direct functions
console.log(green("Build succeeded!"));
console.log(red("Validation failed"));

// 24-bit TrueColor
console.log(hex("#ff7700")("Vibrant Orange Text"));
console.log(rgb(100, 200, 255)("Soft Blue Sky"));

2. Color Space Conversions

import { hexToRgb, rgbToHsl, lighten, darken } from "@omerdev/color-forge";

hexToRgb("#3498db");
// => { r: 52, g: 152, b: 219 }

rgbToHsl(52, 152, 219);
// => { h: 204, s: 70, l: 53 }

lighten("#2c3e50", 15);
// => "#46627f"

darken("#ffffff", 10);
// => "#e6e6e6"

👤 Author

omerdev

📄 License

MIT