Visulima

Getting Started

Visit https://visulima.com/learn to get started with Visulima.

Documentation

Visit https://visulima.com/docs to view the full documentation.

Community

The Visulima community can be found on GitHub Discussions, where you can ask questions, voice ideas, and share your projects.

To chat with other community members you can join the Visulima Discord.

Our Code of Conduct applies to all Visulima community channels.

Contributing

Please see our contributing.md.

Good First Issues

We have a list of good first issues that contain bugs that have a relatively limited scope. This is a great place to get started, gain experience, and get familiar with our contribution process.

@visulima/pail 3.2.2 (2025-11-13)

Bug Fixes

• bump packem, to fix minified version of the code (2a36ceb)

Dependencies

• @visulima/colorize: upgraded to 1.4.29
• @visulima/error: upgraded to 5.0.6
• @visulima/fmt: upgraded to 1.1.21
• @visulima/inspector: upgraded to 1.0.30
• @visulima/redact: upgraded to 2.0.5
• @visulima/string: upgraded to 2.0.6

@visulima/pail 3.2.1 (2025-11-12)

Bug Fixes

• deps: update type-fest dependency across multiple packages (93e13be)
• update package configurations and TypeScript definitions (b59aa59)

Miscellaneous Chores

• Add jsr file to all packages for release (#565) (ec91652)
• pail: add rslog logging to benchmarks (c5675c8)
• pail: integrate roarr logging into benchmarks (563bb52)
• pail: update benchmark results and add rslog performance metrics (123e2b5)
• update license files and clean up TypeScript definitions (fe668cc)

Dependencies

• @visulima/colorize: upgraded to 1.4.28
• @visulima/error: upgraded to 5.0.5
• @visulima/fmt: upgraded to 1.1.20
• @visulima/inspector: upgraded to 1.0.29
• @visulima/redact: upgraded to 2.0.4
• @visulima/string: upgraded to 2.0.5

@visulima/pail 3.2.0 (2025-11-07)

Features

• pail: add child logger functionality with inheritance and overrides (c5dce1d)
• pail: add OpenTelemetryProcessor for enhanced logging with trace context (c7dfb9c)
• pail: implement force logging methods to bypass log level filters (52b8516)
• pail: introduce HTTP Reporter with Edge compatibility and enhanced logging features (9cd695c)

Bug Fixes

• pail: enhance PailBrowserType and PailServerType to extend Console (ce7f2c6)
• update TypeScript configurations and improve linting across multiple packages (6f25ec7)

Miscellaneous Chores

• pail: add simple reporter example for basic usage and advanced features (be16be5)
• pail: update package.json dependencies and fix example scripts (8f98736)
• update npm and pnpm configurations for monorepo optimization (#564) (5512b42)

Code Refactoring

• pail: replace hardcoded '/dev/null' with 'devNull' import for improved cross-platform compatibility (3e8e95d)

Dependencies

• @visulima/colorize: upgraded to 1.4.27
• @visulima/error: upgraded to 5.0.4
• @visulima/fmt: upgraded to 1.1.19
• @visulima/inspector: upgraded to 1.0.28
• @visulima/redact: upgraded to 2.0.3
• @visulima/string: upgraded to 2.0.4

@visulima/pail 3.1.0 (2025-11-05)

Features

• add comprehensive documentation for Pail logging library (6b552ad)
• add interactive module and update package.json (bb9328c)
• pail: add comprehensive documentation, object tree, spinner, and enhanced progress bar (f69738b)

Miscellaneous Chores

• update dependencies in package.json for cerebro and pail (4ff6e98)
• update documentation and improve formatting across multiple files (449b4fb)

@visulima/pail 3.0.3 (2025-11-05)

Bug Fixes

• update dependencies across multiple packages (36a47f2)
• Upgraded type-fest to version 5.2.0 (bd6cd53)

Dependencies

• @visulima/colorize: upgraded to 1.4.26
• @visulima/error: upgraded to 5.0.3
• @visulima/fmt: upgraded to 1.1.18
• @visulima/inspector: upgraded to 1.0.27
• @visulima/redact: upgraded to 2.0.2
• @visulima/string: upgraded to 2.0.3

@visulima/pail 3.0.2 (2025-10-22)

Miscellaneous Chores

• update package dependencies and configurations (7bfe7e7)

Tests

• enhance unit tests with beforeEach for mock cleanup (aba2a50)

Dependencies

• @visulima/string: upgraded to 2.0.2

@visulima/pail 3.0.1 (2025-10-21)

Bug Fixes

• allow node v25 and updated dev deps (8158cc5)

Miscellaneous Chores

• update @visulima/pail dependency to version 3.0.0 in bun package.json (0d5e1de)
• update copyright year in LICENSE.md files (c46a28d)
• update license years and add validation rules (b97811e)

Dependencies

• @visulima/colorize: upgraded to 1.4.25
• @visulima/fmt: upgraded to 1.1.17
• @visulima/inspector: upgraded to 1.0.26
• @visulima/redact: upgraded to 2.0.1
• @visulima/error: upgraded to 5.0.2
• @visulima/string: upgraded to 2.0.1

@visulima/pail 3.0.0 (2025-10-20)

⚠ BREAKING CHANGES

• pail: - Public import paths for reporters changed. Use new scoped reporter entrypoints: Before: import { PrettyReporter } from '@visulima/pail/src/reporter/pretty/pretty.server'; After: import { PrettyReporter } from '@visulima/pail/reporter/pretty'; (Similar changes for raw, simple, json reporters. Browser/server-specific files were renamed e.g. pretty-reporter.server.ts / pretty-reporter.browser.ts and re-exported via reporter/* index files.)
• Deprecated top-level reporter and processor entrypoints removed:
  • Removed: 'src/reporter.server.ts', 'src/reporter.browser.ts'
  • Removed: 'src/processor.server.ts', 'src/processor.browser.ts' Use the dedicated reporter imports under '@visulima/pail/reporter/' and the processor modules under 'src/processor/' as re-exported by the package entrypoints.
• Interactive manager API and types were adjusted (see migration guide). Update usage of interactiveManager and related hooks to the new signatures.
• Types in 'src/types.ts' updated; consuming TypeScript projects may need to adjust imports/usages to match the refined reporter and progress bar types.

Features

• pail: restructure reporters/API and add progress bar (164420a)

Bug Fixes

• deps: update minor updates (#455) (cebf7dc)

Miscellaneous Chores

• add new logging dependencies and benchmarks (9633019)

Dependencies

• @visulima/error: upgraded to 5.0.1

@visulima/pail 2.1.31 (2025-10-15)

Bug Fixes

• downgrade @visulima/redact to version 1.0.15 (3c2a8c2)
• Downgraded @visulima/error to version 4.6.2. (069e946)

@visulima/pail 2.1.30 (2025-10-15)

Bug Fixes

• consolidate ESLint configuration and remove obsolete files for improved maintainability (5b3e825)
• update @visulima/packem to 2.0.0-alpha.32 across multiple packages for improved compatibility (27b346e)

Miscellaneous Chores

• update package dependencies across multiple packages for improved compatibility and performance (9567591)

Dependencies

• @visulima/colorize: upgraded to 1.4.24
• @visulima/error: upgraded to 5.0.0
• @visulima/fmt: upgraded to 1.1.16
• @visulima/inspector: upgraded to 1.0.25
• @visulima/redact: upgraded to 2.0.0

@visulima/pail 2.1.29 (2025-09-23)

Miscellaneous Chores

• update package.json and pnpm-lock.yaml to include publint@0.3.12 and adjust build/test commands to exclude shared-utils (1f7b3c0)

Dependencies

• @visulima/error: upgraded to 4.6.2

@visulima/pail 2.1.28 (2025-09-19)

Miscellaneous Chores

• deps: update build scripts and remove cross-env dependency (7510e82)

Dependencies

• @visulima/error: upgraded to 4.6.1

@visulima/pail 2.1.27 (2025-09-12)

Miscellaneous Chores

• update dependencies and fix linting issues (0e802fe)

Dependencies

• @visulima/error: upgraded to 4.6.0

@visulima/pail 2.1.26 (2025-09-07)

Dependencies

• @visulima/error: upgraded to 4.5.0

@visulima/pail 2.1.25 (2025-06-04)

Dependencies

• @visulima/colorize: upgraded to 1.4.23
• @visulima/error: upgraded to 4.4.18
• @visulima/inspector: upgraded to 1.0.24

@visulima/pail 2.1.24 (2025-05-31)

Dependencies

• @visulima/inspector: upgraded to 1.0.23

@visulima/pail 2.1.23 (2025-05-30)

Bug Fixes

• pail: update dependencies (99bd792)

Miscellaneous Chores

• pail-bench: update devDependencies (94c563c)
• updated dev dependencies (2433ed5)

Dependencies

• @visulima/colorize: upgraded to 1.4.22
• @visulima/error: upgraded to 4.4.17
• @visulima/inspector: upgraded to 1.0.22
• @visulima/redact: upgraded to 1.0.15

@visulima/pail 2.1.22 (2025-03-07)

Bug Fixes

• updated @visulima/packem and other dev deps, for better bundling size (e940581)

Miscellaneous Chores

• updated dev dependencies (487a976)

Dependencies

• @visulima/colorize: upgraded to 1.4.21
• @visulima/error: upgraded to 4.4.16
• @visulima/fmt: upgraded to 1.1.15
• @visulima/inspector: upgraded to 1.0.21
• @visulima/redact: upgraded to 1.0.14

@visulima/pail 2.1.21 (2025-01-26)

Bug Fixes

• pail: dont call extra log on the a function (a272682)

@visulima/pail 2.1.20 (2025-01-25)

Bug Fixes

• fixed wrong node version range in package.json (4ae2929)

Miscellaneous Chores

• fixed typescript url (fe65a8c)
• updated all dev dependencies (37fb298)

Dependencies

• @visulima/colorize: upgraded to 1.4.20
• @visulima/error: upgraded to 4.4.15
• @visulima/fmt: upgraded to 1.1.14
• @visulima/inspector: upgraded to 1.0.20
• @visulima/redact: upgraded to 1.0.13

@visulima/pail 2.1.19 (2025-01-22)

Miscellaneous Chores

• updated all dev dependencies and all dependencies in the app folder (87f4ccb)

Dependencies

• @visulima/colorize: upgraded to 1.4.19
• @visulima/error: upgraded to 4.4.14
• @visulima/inspector: upgraded to 1.0.19
• @visulima/redact: upgraded to 1.0.12

@visulima/pail 2.1.18 (2025-01-13)

Dependencies

• @visulima/colorize: upgraded to 1.4.18
• @visulima/error: upgraded to 4.4.13
• @visulima/inspector: upgraded to 1.0.18

@visulima/pail 2.1.17 (2025-01-12)

Bug Fixes

• updated @visulima/packem, and all other dev dependencies (7797a1c)

Dependencies

• @visulima/colorize: upgraded to 1.4.17
• @visulima/error: upgraded to 4.4.12
• @visulima/fmt: upgraded to 1.1.13
• @visulima/inspector: upgraded to 1.0.17
• @visulima/redact: upgraded to 1.0.11

@visulima/pail 2.1.16 (2025-01-09)

Bug Fixes

• pail: fixed wrong description (14f0d57)

@visulima/pail 2.1.15 (2025-01-08)

Dependencies

• @visulima/colorize: upgraded to 1.4.16
• @visulima/error: upgraded to 4.4.11
• @visulima/inspector: upgraded to 1.0.16

@visulima/pail 2.1.14 (2025-01-08)

Dependencies

• @visulima/colorize: upgraded to 1.4.15
• @visulima/error: upgraded to 4.4.10
• @visulima/inspector: upgraded to 1.0.15

@visulima/pail 2.1.13 (2024-12-31)

Miscellaneous Chores

• updated dev dependencies (9de2eab)

Dependencies

• @visulima/colorize: upgraded to 1.4.14
• @visulima/error: upgraded to 4.4.9
• @visulima/inspector: upgraded to 1.0.14

@visulima/pail 2.1.12 (2024-12-12)

Bug Fixes

• allow node v23 (8ca929a)
• allowed node 23, updated dev dependencies (f99d34e)
• updated packem to v1.8.2 (23f869b)
• updated packem to v1.9.2 (47bdc2d)

Styles

• cs fixes (46d31e0)

Miscellaneous Chores

• updated dev dependencies (a916944)

Dependencies

• @visulima/colorize: upgraded to 1.4.13
• @visulima/error: upgraded to 4.4.8
• @visulima/fmt: upgraded to 1.1.12
• @visulima/inspector: upgraded to 1.0.13
• @visulima/redact: upgraded to 1.0.10

@visulima/pail 2.1.11 (2024-10-05)

Dependencies

• @visulima/colorize: upgraded to 1.4.12
• @visulima/error: upgraded to 4.4.7
• @visulima/inspector: upgraded to 1.0.12

@visulima/pail 2.1.10 (2024-10-05)

Bug Fixes

• updated dev dependencies, updated packem to v1.0.7, fixed naming of some lint config files (c071a9c)

Dependencies

• @visulima/colorize: upgraded to 1.4.11
• @visulima/error: upgraded to 4.4.6
• @visulima/fmt: upgraded to 1.1.11
• @visulima/inspector: upgraded to 1.0.11
• @visulima/redact: upgraded to 1.0.9

@visulima/pail 2.1.9 (2024-09-24)

Bug Fixes

• update packem to v1 (05f3bc9)
• updated esbuild from v0.23 to v0.24 (3793010)

Miscellaneous Chores

• updated dev dependencies (05edb67)

Dependencies

• @visulima/colorize: upgraded to 1.4.10
• @visulima/error: upgraded to 4.4.5
• @visulima/fmt: upgraded to 1.1.10
• @visulima/inspector: upgraded to 1.0.10
• @visulima/redact: upgraded to 1.0.8

@visulima/pail 2.1.8 (2024-09-11)

Bug Fixes

• fixed node10 support (f5e78d9)

Miscellaneous Chores

• updated dev dependencies (28b5ee5)

Dependencies

• @visulima/colorize: upgraded to 1.4.9
• @visulima/error: upgraded to 4.4.4
• @visulima/fmt: upgraded to 1.1.9
• @visulima/inspector: upgraded to 1.0.9
• @visulima/redact: upgraded to 1.0.7

@visulima/pail 2.1.7 (2024-09-07)

Bug Fixes

• fixed broken chunk splitting from packem (1aaf277)

Dependencies

• @visulima/colorize: upgraded to 1.4.8
• @visulima/error: upgraded to 4.4.3
• @visulima/fmt: upgraded to 1.1.8
• @visulima/inspector: upgraded to 1.0.8
• @visulima/redact: upgraded to 1.0.6

@visulima/pail 2.1.6 (2024-09-07)

Bug Fixes

• added types support for node10 (604583f)

Styles

• cs fixes (f5c4af7)

Miscellaneous Chores

• update dev dependencies (0738f98)

Dependencies

• @visulima/colorize: upgraded to 1.4.7
• @visulima/error: upgraded to 4.4.2
• @visulima/fmt: upgraded to 1.1.7
• @visulima/inspector: upgraded to 1.0.7
• @visulima/redact: upgraded to 1.0.5

@visulima/pail 2.1.5 (2024-08-30)

Bug Fixes

• pail: update safe-stable-stringify package to version 2.5.0 (e463964)

Styles

• pail: cs fix (06b3af0)

Miscellaneous Chores

• updated dev dependencies (45c2a76)

Dependencies

• @visulima/colorize: upgraded to 1.4.6
• @visulima/error: upgraded to 4.4.1
• @visulima/inspector: upgraded to 1.0.6
• @visulima/redact: upgraded to 1.0.4

@visulima/pail 2.1.4 (2024-08-08)

Miscellaneous Chores

• updated dev dependencies (da46d8e)

Dependencies

• @visulima/error: upgraded to 4.4.0

@visulima/pail 2.1.3 (2024-08-04)

Dependencies

• @visulima/colorize: upgraded to 1.4.5
• @visulima/error: upgraded to 4.3.2
• @visulima/inspector: upgraded to 1.0.5

@visulima/pail 2.1.2 (2024-08-01)

Bug Fixes

• upgraded @visulima/packem (dc0cb57)

Miscellaneous Chores

• updated dev dependencies (ac67ec1)

Dependencies

• @visulima/colorize: upgraded to 1.4.4
• @visulima/error: upgraded to 4.3.1
• @visulima/fmt: upgraded to 1.1.6
• @visulima/inspector: upgraded to 1.0.4
• @visulima/redact: upgraded to 1.0.3

@visulima/pail 2.1.1 (2024-07-22)

Miscellaneous Chores

• updated dev dependencies and sorted the package.json (9571572)

Dependencies

• @visulima/inspector: upgraded to 1.0.3

@visulima/pail 2.1.0 (2024-07-10)

Features

• pail: added new options for the json error serializer (6df9535)

@visulima/pail 2.0.1 (2024-07-09)

Bug Fixes

• fail: fixed types for error and inspect options (cc4202c)

@visulima/pail 2.0.0 (2024-07-09)

⚠ BREAKING CHANGES

• removed abstract-file-reporter - the new base is now the AbstractJsonReporter, removed ErrorProcessor - was replaced with @visulima/error Signed-off-by: prisis d.bannert@anolilab.de

Features

• switched error serialize to @visulima/error, export type for reporter options (a761356)

@visulima/pail 1.4.4 (2024-07-09)

Bug Fixes

• pail: adding better error view (#450) (21f3622)

Styles

• cs fixes (ee5ed6f)
• cs fixes (cf19938)
• cs fixes found by eslint and prettier (69ef744)

Miscellaneous Chores

• added private true into fixture package.json files (4a9494c)
• changed typescript version back to 5.4.5 (55d28bb)
• pail: fixed benchmarks (238aeaf)
• updated dev dependencies (34df456)
• updated dev dependencies (c889486)

@visulima/pail 1.4.3 (2024-06-14)

Bug Fixes

• pail: fixed striping of spaces from messages (6d6ae8b)

@visulima/pail 1.4.2 (2024-06-14)

Bug Fixes

• pail: fixed broken grouping of logs (2922a17)

@visulima/pail 1.4.1 (2024-06-14)

Bug Fixes

• pail: fixed missing warning on timeEnd, added more tests, fixed wrong default of pail server and browser (a67254d)

@visulima/pail 1.4.0 (2024-06-14)

Features

• pail: adding inspector into pretty reporters (#424) (76b1435)

@visulima/pail 1.3.1 (2024-06-14)

Bug Fixes

• pail: fixed rendering of undefined and null as a message (eb80d23)

Styles

• pail: cs fixes (f1b9549)

@visulima/pail 1.3.0 (2024-06-14)

Features

• pail: added new redact processor (#423) (0614067)

@visulima/pail 1.2.2 (2024-06-14)

Bug Fixes

• pail: fixed wrong global import of rotating-file-stream, this did call the require to early (ac0c8bc)

@visulima/pail 1.2.1 (2024-06-13)

Bug Fixes

• pail: fixed wrong require use of rotating-file-stream (37d9353)
• pail: moved import of rotating-file-stream into a lazy import, removed wrong never typing (0513e27)

@visulima/pail 1.2.0 (2024-06-13)

Features

• added simple reporter, fixed caller return, changed log color (#418) (e22b954)

@visulima/pail 1.1.13 (2024-06-13)

Miscellaneous Chores

• updated all dev deps (ef143ce)

Build System

• fixed found audit error, updated all dev package deps, updated deps in apps and examples (4c51950)

Dependencies

• @visulima/colorize: upgraded to 1.4.3

@visulima/pail 1.1.12 (2024-06-06)

Bug Fixes

• allow node v22 (890d457)

Miscellaneous Chores

• updated dev dependencies (a2e0504)

Dependencies

• @visulima/colorize: upgraded to 1.4.2
• @visulima/fmt: upgraded to 1.1.5

@visulima/pail 1.1.11 (2024-05-24)

Styles

• cs fixes (7bf5b91)

Miscellaneous Chores

• changed semantic-release-npm to pnpm (b6d100a)
• updated dev dependencies (2e08f23)
• updated dev dependencies (abd319c)
• updated dev dependencies (0767afe)
• updated dev dependencies (d7791e3)
• updated dev dependencies (6005345)

Dependencies

• @visulima/colorize: upgraded to 1.4.1

@visulima/pail 1.1.10 (2024-04-27)

Bug Fixes

• api-platform: updated ts-japi dep (4f4d29f)

@visulima/pail 1.1.9 (2024-04-17)

Bug Fixes

• pail: fixed log rendering for small terminal, exported error processor (47afd8a)

@visulima/pail 1.1.8 (2024-04-10)

Dependencies

• @visulima/colorize: upgraded to 1.4.0

@visulima/pail 1.1.7 (2024-04-09)

Dependencies

• @visulima/colorize: upgraded to 1.3.3

@visulima/pail 1.1.6 (2024-04-09)

Dependencies

• @visulima/colorize: upgraded to 1.3.2

@visulima/pail 1.1.5 (2024-04-07)

Bug Fixes

• pail: fixed error handling as context (#389) (f24e3a0)

@visulima/pail 1.1.4 (2024-03-30)

Bug Fixes

• pail: fixed wrong function call on wrapConsole (0ae24cf)

@visulima/pail 1.1.3 (2024-03-27)

Bug Fixes

• added missing os key to package.json (4ad1268)

Dependencies

• @visulima/colorize: upgraded to 1.3.1
• @visulima/fmt: upgraded to 1.1.4

@visulima/pail 1.1.2 (2024-03-19)

Bug Fixes

• pail: fixed cjs export (#352) (cf84ce6)

@visulima/pail 1.1.1 (2024-03-07)

Bug Fixes

• fixed logger function type, for better input typing (f08bbd4)

@visulima/pail 1.1.0 (2024-03-04)

Features

• adding new gradient helper (#324) (49b1ab0)

Bug Fixes

• fixed all found type issues (eaa40d1)
• minifyWhitespace on prod build, removed @tsconfig/* configs (410cb73)

Dependencies

• @visulima/colorize: upgraded to 1.3.0
• @visulima/fmt: upgraded to 1.1.3

@visulima/pail 1.0.0 (2024-02-28)

Features

• added all tests to the is-ansi-color-supported, updated deps (6639e75)
• added correct badge display, adding new docs (5c7ff29)
• added count and countReset, fixed time, timeLog and timeEnd (bef8926)
• added header images (21e8d5a)
• added more docs (ec33d26)
• added new color pacakge (ca23c3d)
• added new interactive manager, fixed tests, fixed styling, and more (e7359d3)
• added tests (e30de63)
• added time, timeLog and timeEnd, better design for browser console, some fixes (737378a)
• adding interactive mode (a88ccb4)
• adding new raw reporter and raw function to pail (#320) (e6cf56f)
• fixed some design issues between server and browser, added trace (57a34b6)
• improvement (1964590)
• more work (3d41672)
• more work (435ca60)
• more work on the logger (01f2f94)
• more work on the logger (3b8b1f0)
• more work on the logger (93b658b)
• more work on the logger (95e5f2a)
• more work on the logger (93a9d4c)
• new color and support color package (c580e05)
• new console interface func, fixed some eslint errors (84917bd)
• removed child handling (39abe92)
• removed some deps (bd6150a)
• speed up pail (2caab01)
• split pail into browser class and server class (23dbcd6)
• updated readme (69278b3)
• updated readme (faa6425)
• updated readme (10adfed)
• updated string template to normale strings (a796e0f)

Bug Fixes

• added missing exports (0d0ad93)
• fixed build step (a882a13)
• fixed cjs export, fixed eslint errors (d401258)
• fixed fmt handling (a0b2352)
• fixed found issues (858bc32)
• fixed package.json exports (685b636)
• fixed test (c1b56f6)
• fixed tests (a3df0e2)

Dependencies

• @visulima/colorize: upgraded to 1.2.2