console-glow

🌈 console-glow

Stylish console logging with themes, emojis, and color — for developers who like their CLI with ✨ personality.

🚀 Features

• 🎨 Multiple themes: neon, hacker, retro, matrix, and more
• ✅ Predefined log types: success, error, warn, info
• 🔍 Log levels with filtering capability
• 📆 File logging with automatic rotation
• 💡 Chainable API: glow.theme('neon').log("Hello")
• 🧠 First-class TypeScript support
• 📝 ASCII art and boxed message formatting
• 🕵️‍♂️ Metadata support for debugging
• 📜 Log history export options

📦 Installation

npm install console-glow
# or
yarn add console-glow
# or
pnpm add console-glow

💻 Usage

Basic Logging (Quick Start)

import { glow } from 'console-glow';

// Predefined log types with emojis
glow.success('Database connected!');        // ✅ green
glow.error('Invalid credentials!');         // ❌ red 
glow.warn('Session expires soon!');         // ⚠️ yellow
glow.info('Server listening on port 3000'); // ℹ️ blue

// Themed logging (chainable API)
glow.theme('neon').log('System initialized!'); // 🌈 pink/purple
glow.theme('hacker').log('Access granted!');    // 💚 green matrix style

Advanced Logging

import { logger } from 'console-glow';

// 1. Configure logger
logger
  .setTheme('matrix')
  .setLevel('debug')
  .enableFileLogging('./app.log');

// 2. Log with metadata
logger.debug('User action', { 
  userId: 123, 
  action: 'login',
  timestamp: new Date() 
});

// 3. Special formats
logger.asciiArt('WELCOME');
logger.boxed('Critical security update required!', 'ALERT');

// 4. Export logs
await logger.exportHistory('json'); // Also supports 'txt'

Real-world Examples

glow.theme('rainbow').asciiArt('MY API');
glow.info(`Starting in ${process.env.NODE_ENV} mode`);
glow.success(`Connected to ${dbConfig.host}`);

// Only show debug logs in development
if (process.env.NODE_ENV === 'development') {
  logger.setLevel('debug');
}

CLI Tool

try {
  glow.theme('retro').log('Processing files...');
  await processFiles();
  glow.success(`Processed ${count} files!`);
} catch (err) {
  glow.error('Failed:', err.message);
  logger.debug('Stack trace:', { stack: err.stack });
  process.exit(1);
}

Interactive Prompts

glow.boxed('Welcome to the setup wizard!', '👋');
glow.warn('This will modify system files');
glow.theme('neon').log('Proceed? [Y/n]');

Enjoy stylish logging with console-glow ✨