vico-logger-discord

A powerful Node.js logger built on Winston, designed for development and production:

• Daily log rotation for easy management
• Sends error level logs (and optionally other levels) to Discord via webhook
• Colorized console output for better readability during development
• Fully compatible with ESM, CommonJS, and TypeScript

---

Installation

npm install vico-logger

---

Usage

JavaScript (ESM)

import logger from "vico-logger";

logger.info("Hello from ESM!");
logger.error("This will also send to Discord if webhook is set.");

JavaScript (CommonJS)

const logger = require("vico-logger");

logger.warn("Hello from CJS!");
logger.debug("This is a debug message.");

TypeScript

import logger from "vico-logger";

logger.verbose("Verbose log example");
logger.silly("Silly log example for testing purposes");

---

Environment Variables

DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/xxx/yyy
LOG_LEVEL=info

• DISCORD_WEBHOOK_URL: Your Discord webhook URL (optional, only needed if you want error logs sent to Discord)
• LOG_LEVEL: Minimum log level to log (default: info)

---

Winston Log Levels

vico-logger supports all default Winston log levels:

Level	Numeric	Description
error	0	Critical errors, sent to Discord if webhook is configured
warn	1	Warnings, important but non-critical issues
info	2	General operational messages, e.g., server start, requests
http	3	HTTP requests logs
verbose	4	Detailed logs for debugging
debug	5	Debug messages for development
silly	6	Extremely detailed, usually only for testing and experimentation

You can use any of these levels via logger.level("info") or directly:

logger.error("Critical error");
logger.debug("Debugging info");

---

Create a Discord Webhook

1. Open Discord and select the server where you want the logs to appear.
2. Go to Server Settings → Integrations → Webhooks.
3. Click New Webhook.
4. Give it a name (e.g., Logger Bot) and select the channel for logs.
5. Click Copy Webhook URL → set it as DISCORD_WEBHOOK_URL in your .env file.

Example URL

https://discord.com/api/webhooks/123456789012345678/abcdefghijklmnopqrstuvwxyz

---

Example: Sending Logs to Discord

import logger from "vico-logger";

// This will appear in console and on Discord if level is 'error'
logger.error("Database connection failed!");

// Other levels will only appear in console by default
logger.info("Server started on port 3000");

---

This README now provides clear guidance for:

• Installation & usage (ESM, CJS, TypeScript)
• Environment variables setup
• All Winston log levels and their purpose
• Discord webhook setup and usage