🎨 Logluxe

"Install once, never think about logs again."

Logluxe is a tiny, zero-dependency, TypeScript-first logging utility that serves as a drop-in replacement for console.* with beautiful colored logs, smart defaults, and zero configuration required.

✨ Why Logluxe?

Feature	Logluxe	Console	Other Loggers
Zero Config	✅	✅	❌
Beautiful Colors	✅	❌	⚠️
TypeScript First	✅	❌	⚠️
Zero Dependencies	✅	✅	❌
Browser + Node	✅	✅	⚠️
Tree Shakable	✅	N/A	⚠️
Bundle Size	~2KB	0KB	10-50KB

🚀 Quick Example

import log from 'logluxe';

// Semantic logging with beautiful colors
log.success('Build complete');        // ✔ Build complete (green)
log.error('Database failed');         // ✖ Database failed (red)
log.warn('Memory usage high');        // ⚠ Memory usage high (yellow)
log.info('Server started');           // ℹ Server started (cyan)
log.debug('Request payload', data);   // ● Request payload (gray)

// Or use the drop-in console patch
import 'logluxe/patch';
console.info('Now with colors!');     // ℹ Now with colors! (cyan)

Console Output

✔✔ Build complete

✖✖ Database failed

⚠⚠ Memory usage high

ℹℹ Server started

●● Request payload { id: 1, name: 'test' }

ℹℹ Now with colors!

🎮 Try it yourself

log.success('Build complete'); log.error('Database failed'); log.warn('Memory usage high'); log.info('Server started'); log.debug('Request payload', { id: 1 });

🎯 Key Features

🪶 Lightweight

• Zero dependencies - Pure TypeScript, nothing else
• < 2KB minified - Tiny footprint, massive functionality
• Tree-shakable - Import only what you need

🌍 Universal

• Node.js - Full ANSI color support
• Browser - CSS-based styling in DevTools
• Deno & Bun - First-class support
• React/Next.js/Vite - Works out of the box

🎨 Beautiful

• Semantic colors - Success is green, errors are red
• Gradient text - Eye-catching rainbow effects
• Chainable styles - Build complex styles fluently

🔧 Developer Experience

• Full TypeScript support - Complete type definitions
• IntelliSense - Autocomplete everything
• Zero config - Works immediately after install

📦 Installation

npm install logluxe
# or
yarn add logluxe
# or
pnpm add logluxe

Terminal

$ npm install logluxe

added 1 package in 2s

🎬 See It In Action

Terminal Output

Semantic Logging

✔✔ Build complete

✖✖ Database connection failed

⚠⚠ Memory usage is at 85%

ℹℹ Server listening on port 3000

●● Debug: Processing 42 items

With Effects

Visual Effects

🌈 H e l l o W o r l d

◆ SERVER ONLINE

═══════════════════════════════════════

║ Welcome to My CLI Tool ║

═══════════════════════════════════════

🎮 Try Visual Effects

log.success('Build completed successfully!'); log.info('Starting server...'); log.warn('Using default configuration'); log.error('Unable to connect'); log.debug('Debug mode enabled');

🗺️ Documentation Structure

• Getting Started - Installation, quick start, console patch
• Core API - Semantic logging, colors, style builder
• Effects & Utilities - Gradients, highlights, banners
• Advanced Features - Performance, themes, configuration
• Examples - Real-world usage patterns

💡 Philosophy

Logluxe is built on three principles:

1. Zero Friction - Should work immediately with no setup
2. Non-Invasive - Easy to add, easy to remove if needed
3. Sensible Defaults - Beautiful output without configuration

---

Ready to get started? Head to the Installation Guide →