Skip to content

logo_esm logo_ts logo_bun

Basalt Logger

Warning

Basalt is my first small project that I'm publishing. Please be understanding and don't hesitate to give me feedback about your experience: basalt-lab@proton.me or via Discord necrelox.

🏗️ Introduction

Basalt Logger is a flexible and non-blocking logging package.
It offers the possibility to implement multiple log redirection strategies and allows you to select one or more strategies according to your needs.

Basalt Logger perfectly adapts to any project requiring detailed, customizable, and high-performance logging. Its modular design makes it an ideal tool for efficiently managing your application's logs.

❓ Why Basalt Logger?

The choice of Basalt Logger is based on several key advantages:

  • Performance and Lightweight: Zero external dependencies and minimal memory footprint
  • Simplicity: Intuitive API and clear documentation for quick adoption
  • Flexibility: Modular architecture allowing custom logging strategies
  • Non-Blocking: Designed to not impact your application's performance
  • Versatility: Adapts to all environments (console, files, external services)
  • Extensibility: Create your own logging strategies according to your specific needs

📦 Package Information

Basalt packages are available in two versions:

  • Stable: Default version, recommended for production (@basalt-lab/basalt-logger)
  • Canary: Latest development version with newest features (@basalt-lab/basalt-logger@canary)

To install a specific version, use the corresponding tags during installation.

Version Unpacked Size Minified Gzipped
NPM Latest version NPM Unpacked Size NPM Package minimized gzipped size
NPM canary version NPM Unpacked Size (Canary) -

⚡ Installation

Integrating Basalt Logger into your project is a breeze.

Package: @basalt-lab/basalt-logger

Follow these steps to add it to your project:

Bun: 

bun add @basalt-lab/basalt-logger
Or canary version 
bun add @basalt-lab/basalt-logger@canary

bun add @basalt-lab/basalt-loggerinstalled @basalt-lab/basalt-logger@[version]

You're ready to start! Happy coding 🚀