🚀 LoggyLogger

Zero-config logging with a live web dashboard for Node.js.

LoggyLogger is a standalone logging system with built-in web dashboard support. No external APIs, no cloud services - just import and log.

❔ Features

• 🚀 Instant setup - Import, create logger, done
• 🏠 Live web dashboard - Real-time log visualization with filtering
• ⚡ Production mode - Disable heavy features with one call
• 📈 Bound data - Attach persistent metadata to loggers for easier debugging
• 🧪 Call line tracking - See exactly where each log originated

🖼️ Screenshots

Full logging dashboard

Custom code snippet checks

Filter out logs by file and line range

Install

npm install loggylogger

Basic Usage

import { Loggy } from 'loggylogger'

// Create a logger
const logger = Loggy.createLogger()

// Start logging
logger.log('Server started')
logger.warn('Cache miss', { userId: 42 })
logger.error('Connection failed', new Error('timeout'))
logger.debug('Request payload', requestData)

// Debug on the dashboard by enabling it
Loggy.startDashboard(3000) // default port is 11000
// Attach debug datas to your logs
logger.bind({ service: 'auth', child_process: 2 }).info('Auth system started.')

Log Levels

9 levels from critical to silly:

logger.fatal('System crash')        // Level 10 - Highest priority
logger.error('Operation failed')    // Level 20
logger.warn('Deprecation notice')   // Level 30
logger.success('Task completed')    // Level 40
logger.info('Status update')        // Level 50
logger.log('General message')       // Level 60 - Default mode
logger.debug('Debug info')          // Level 70
logger.verbose('Detailed trace')    // Level 80
logger.silly('Very precise trace')  // Level 90 - Lowest priority

Set the threshold level:

// Only show logs at or above this level
Loggy.setLevel(Loggy.LEVELS['7_DEBUG'])

// Or via setConfig
Loggy.setConfig({ level: Loggy.LEVELS['5_INFO'] })

Configuration

Global Config

Use setConfig() to configure all loggers:

import { Loggy } from 'loggylogger'

Loggy.setConfig({
    level: Loggy.LEVELS.DEFAULT, // 60, logs and above
    colors: true,
    emojis: true,
    showCallLines: true,
    colors: true,
    convertObjects: true,
    convertObjectsColorized: true,
    convertObjectsDepth: 2,
    basePath: process.cwd()  // Makes call lines relative to your project
})

const logger = Loggy.createLogger()

Per-Logger Config

Override global settings for specific loggers:

// Quiet logger without colors
const quietLogger = Loggy.createLogger({
    level: Loggy.LEVELS['3_WARN'],
    colors: false
})

// Verbose logger for debugging
const debugLogger = Loggy.createLogger({
    level: Loggy.LEVELS['8_VERBOSE'],
    showCallLines: true,
    convertObjects: true,
    convertObjectsDepth: 5
})

Bound Data

Attach persistent metadata to a logger using the second parameter or .bind():
This is espacially usefull to make logging groups accross files to show at once on dashboard

// Attach data at creation
const logger = Loggy.createLogger({}, {
    service: 'auth',
    version: '1.0.0'
})

// Or bind data to an existing logger
const requestLogger = logger.bind({
    requestId: req.id,
    userId: user.id
})

requestLogger.info('Processing request')
// Output includes: { service: 'auth', version: '1.0.0', requestId: '...', userId: '...' }

Live Dashboard

Start a web dashboard to view logs in real-time:

import { Loggy } from 'loggylogger'

// Start dashboard on port 11000 (default)
Loggy.startDashboard()

// Or specify a custom port
Loggy.startDashboard(3000)

// Use port 0 to let the OS assign an available port
Loggy.startDashboard(0)
const port = Loggy.getDashboardPort() // Retrieve the assigned port

// Stop when done
Loggy.stopDashboard()

⚠️ Important security note: The dashboard is intended for local debugging use only and should not be exposed to public or untrusted networks. It lacks authentication and should and was not designed to be publicly accessible. By default it only listens on 127.0.0.1

Production Mode

Enable production mode to disable heavy features and only log critical messages:
When set to false, functionnalities are replaced by empty functions to remove avoid processing

import { Loggy } from 'loggylogger'

if(process.env.NODE_ENV == 'production') {
    Loggy.enableProduction({
        // Enable/disable specific log levels.
        logs: {
            fatal: true,
            error: true,
            warn: true,
            info: false,
            debug: false
        },
        // Override settings in production.
        settings: {
            colors: false,
            objectInspect: false,
            callLine: false
        },
        // Optionally enable dashboard in production
        dashboard: false // ⚠️ Warning: enabling dashboard in production may lead to security vulnerabilities if handled incorrectly. Only enable if necessary and ensure proper network security measures are in place.
    }, 11000)  // Optionnal, dashboard port if enabled (default: 11000)
}

Disable production mode on runtime (not fully supported & not recommended):

Loggy.disableProduction()

You may restart production later on without specifying again the config by simply doing

Loggy.enableProduction()

Configuration Options

Option	Type	Default	Description
level	number	60	Log level threshold (use Loggy.LEVELS)
colors	boolean	true	Enable ANSI colors in output
emojis	boolean	true	Show emoji indicators
showCallLines	boolean	false	Show file:line for each log
cleanDate	boolean	true	Clean timestamp format
convertObjects	boolean	false	Deep inspect objects with util.inspect
convertObjectsColorized	boolean	true	Colorize inspected objects
convertObjectsDepth	number	2	Depth for object inspection
basePath	string	-	Base path for relative call line paths

Available Levels

Loggy.LEVELS = {
    'DEFAULT': 60,
    '1_FATAL': 10,
    '2_ERROR': 20,
    '3_WARN': 30,
    '4_SUCCESS': 40,
    '5_INFO': 50,
    '6_LOG': 60,
    '7_DEBUG': 70,
    '8_VERBOSE': 80
    '9_SILLY': 90,
}

API Reference

Loggy (default instance)

Method	Description
createLogger(config?, boundData?)	Create a new logger instance
setConfig(config)	Set global configuration
setLevel(level)	Set global log level
getLevel()	Get current log level
toggleColors(value?)	Toggle color output
startDashboard(port?)	Start the web dashboard
stopDashboard()	Stop the web dashboard
enableProduction(config?, port?)	Enable production mode
disableProduction()	Disable production mode
isProduction()	Check if production mode is enabled

Logger Instance

Method	Description
fatal(...args)	Log fatal error
error(...args)	Log error
warn(...args)	Log warning
success(...args)	Log success
info(...args)	Log info
log(...args)	Log general message
debug(...args)	Log debug info
verbose(...args)	Log verbose details
silly(...args)	Log silly details
bind(data)	Create logger with additional bound data