I've made this simple logging system to help keep my logging consistent across projects. While unoriginal, it's a somewhat decent package for those looking for the same ideas I had in mind, since this one's a little different from others I've wanted to use.

Features

• ✅ Customizable application name.
• ✅ Customizable colors for everything.
• ✅ No Dependencies, very demure.
• ✅ Optional Debug mode.
• ✅ Optional ASCII kitty meow on errors.

Installation

This can be made via your package manager of choice, here's npm as an example:

npm install logena

Functions

logena.set

Parameters

• config: An object containing configuration options.
• debug (optional): boolean - Enable or disable debug mode.
• appName (optional): string - Set the application name.
• useTimestamps (optional): boolean - Enable or disable timestamps in logs.
• meowOnError (optional): boolean - When true, prints an ASCII kitty before error logs.
• errorCatAscii (optional): string - Custom ASCII cat text shown when meowOnError is enabled.
• colors (optional): object - Customize colors.
• timestamp: string - Color for the timestamp.
• appName: string - Color for the application name.
• message: string - Color for the message.
• levels: object - Customize colors for different log levels.
• info: string - Color for info level logs.
• warn: string - Color for warn level logs.
• error: string - Color for error level logs.
• debug: string - Color for debug level logs.

logena.info

Parameters

• appName (optional): string - Set the application name (Overrides preset name).
• message: string | object - The message to log.

logena.warn

Parameters

• appName (optional): string - Set the application name (Overrides preset name).
• message: string | object - The message to log.

logena.error

Parameters

• appName (optional): string - Set the application name (Overrides preset name).
• message: string | object - The message to log.

logena.debug (ONLY LOGS IF DEBUG MODE IS ENABLED VIA logena.set)

Parameters

• appName (optional): string - Set the application name (Overrides preset name).
• message: string | object - The message to log.

---

Note: If you set appName on any log level function (e.g., logena.info, logena.warn, etc.), it will override the preset application name only for that specific function call.

JS/TS Examples

Both default and named imports work in TypeScript. CommonJS supports destructuring or default require.

// TypeScript: default import
import Logena from "logena";
// TypeScript: named import (also works)
import { Logena } from "logena";
// JavaScript/CommonJS: destructured require
const { Logena } = require("logena");

Then configure and use:

Logena.set({
	debug: true,
	appName: "LOGENA",
	meowOnError: true,
	colors: {
		appName: "red",
		levels: {
			info: "green",
		},
	},
	useTimestamps: true,
});
Logena.info("Hello, world!"); // 2024-10-15 18:00:00Z [LOGENA] INFO: Hello, world!
Logena.warn("Hello, world!"); // 2024-10-15 18:00:00Z [LOGENA] WARN: Hello, world!
Logena.error("Hello, world!"); // 2024-10-15 18:00:00Z [LOGENA] ERROR: Hello, world!
Logena.debug("Hello, world!"); // 2024-10-15 18:00:00Z [LOGENA] DEBUG: Hello, world!

Performance

Benchmarked at 100,000 iterations per level with console I/O suppressed, on an AMD Ryzen 9 9950X3D running Ubuntu 25.10.

Level	Median	p95	p99	Mean	Ops/sec
info	40 ns	60 ns	140 ns	54 ns	25,000,000
warn	110 ns	130 ns	230 ns	151 ns	9,090,909
error	60 ns	80 ns	90 ns	68 ns	16,666,667
debug	190 ns	220 ns	270 ns	211 ns	5,263,158

Total RSS growth across all levels: +11.695 MB

Benchmarks are measured with console I/O suppressed to isolate formatting overhead. Real-world numbers will vary depending on output destination and system load.

License

MIT :3

Contributing

Want to contribute? Feel free to fork and make a pull request! Every contribution will be reviewed and appreciated.

Hall of Contributors

• None yet, be the first?