Visulima

The TypeScript toolbox for building modern Node.js, browser, edge, and CLI applications.

44+ independent, production-ready packages. Pick only what you need.

---

---

What is Visulima?

Visulima is a curated collection of small, focused TypeScript libraries that solve the problems you hit every day when shipping real applications. Things like parsing CLI args, formatting terminal output, handling files and paths, debugging errors with readable stack traces, building APIs, sending emails, redacting secrets, and dozens more.

Every package is standalone. Install one, install ten, mix them with whatever framework you already use. No lock-in, no umbrella runtime.

Why Visulima?

• Modular by design. Every package has a single responsibility and ships independently. Use @visulima/fs without touching anything else.
• Modern runtimes. Pure ESM that works in Node.js, Bun, Deno, edge runtimes, and (where it makes sense) the browser.
• TypeScript-native. Written in TypeScript with strict types, full inference, and "sideEffects": false for clean tree-shaking.
• Production-tested. High test coverage, Vitest-driven, used in real products.
• Well-documented. Every package has a dedicated doc page on visulima.com, plus a README with examples and API reference.
• MIT licensed. Free to use, free to fork.

Drop-in replacements

Already using one of these? Swap it out without changing your code:

You're using	Try	What you get
node:path	@visulima/path	Same API, normalized paths, smaller and faster.
chalk	@visulima/colorize	Chalk-compatible API, up to 3× faster, with nested templates.
ink	@visulima/tui	Ink-compatible React API, backed by a native Rust diff engine.

Powered by native Rust

Performance-critical packages ship with NAPI bindings and a JS fallback. Fast where it matters, portable everywhere.

• @visulima/tui uses a native Rust diff engine for the React-to-terminal renderer.
• @visulima/secret-scanner is a Rust port of gitleaks detection, exposed via NAPI.
• @visulima/task-runner runs concurrent processes with native Rust performance and process-tree cleanup on every OS.

Install

Install only the packages you need:

# pnpm
pnpm add @visulima/pail @visulima/fs

# npm
npm install @visulima/pail @visulima/fs

# yarn
yarn add @visulima/pail @visulima/fs

Every package has a dedicated doc page on visulima.com with usage examples and full API reference.

What's inside

Packages are grouped into eight categories. Jump to the section you need:

• API: routing, CRUD, OpenAPI, pagination, health checks
• Data Manipulation: strings, objects, bytes, HTML, redaction, locales
• Email: multi-provider sending, templates, disposable-domain detection
• Error Debugging: stack traces, source maps, loggers, dev overlays
• Filesystem: human-friendly fs helpers, path utilities, cache directories
• Storage: S3, Azure, GCS, and local file uploads with a unified API
• Terminal: CLIs, colors, spinners, progress bars, tables, TUI
• Tooling: task runner, secret scanner, tsconfig parser, package utilities

All Packages

API

Package	Version	Description
@visulima/health-check	npm	A library built to provide support for defining service health for node services. It allows you to register async health checks for your dependencies and the service itself, provides a health endpoint that exposes their status, and health metrics.
@visulima/jsdoc-open-api	npm	Generates swagger doc based on JSDoc.
@visulima/pagination	npm	Simple Pagination for Node.

Data Manipulation

Package	Version	Description
@visulima/bytes	npm	Utility functions to make dealing with Uint8Arrays easier
@visulima/content-safety	npm	Content safety filtering with multi-language banned word detection. Supports 19 languages with word-boundary matching, match position reporting, and both browser and server runtime compatibility.
@visulima/deep-clone	npm	Fastest deep clone implementation.
@visulima/html	npm	Functions for HTML, such as escaping or unescaping HTML entities
@visulima/humanizer	npm	Humanizer is a library for humanizing data in a human-readable form.
@visulima/iso-locale	npm	ISO data for countries, currencies, regions, timezones, and BCP 47 locale support.
@visulima/object	npm	Helper functions for working with objects and arrays.
@visulima/redact	npm	A library for redacting and masking sensitive data from objects and strings, with support for GDPR compliance, custom rules, and deep object traversal.
@visulima/string	npm	Functions for manipulating strings.

Email

Package	Version	Description
@visulima/disposable-email-domains	npm	A regularly updated list of disposable and temporary email domains.
@visulima/email	npm	A comprehensive email library with multi-provider support, crypto utilities, and template engines
@visulima/email-provider-mx	npm	Classify the email provider (mailbox host or secure email gateway) behind an MX record.
@visulima/email-verifier	npm	Mailer-free email address verification and enrichment: syntax, MX/SMTP probing, disposable/free/role detection, catch-all, provider & secure-email-gateway classification, typo suggestions, and a 0–100 quality score.
@visulima/free-email-domains	npm	A regularly updated list of free email service provider domains.

Error Debugging

Package	Version	Description
@visulima/dev-toolbar	npm	Devtools is a set of tools for building advanced devtools for your application
@visulima/error	npm	Error with more than just a message, stacktrace parsing.
@visulima/error-handler	npm	Error handlers for use in development and production environments.
@visulima/inspector	npm	Inspect utility for Node.js and Browsers.
@visulima/ono	npm	Ono is an error-parsing library that pretty prints JavaScript errors on a web page or the terminal.
@visulima/pail	npm	Highly configurable Logger for Node.js, Edge and Browser.
@visulima/source-map	npm	Provides functionality related to source maps.
@visulima/vite-overlay	npm	Improved vite overlay

Filesystem

Package	Version	Description
@visulima/find-cache-dir	npm	Finds the common standard cache directory
@visulima/fs	npm	Human friendly file system utilities for Node.js
@visulima/path	npm	Drop-in replacement of the Node.js path module.

Notification

Package	Version	Description
@visulima/notification	npm	A reusable, ESM-only, edge-ready multi-channel notification library with SMS, push, chat, in-app and webhook providers

Storage

Package	Version	Description
@visulima/storage	npm	Server-side file-storage abstraction - store files in a web-accessible location via a simplified API. Includes S3, Azure, GCS, local filesystem and 20+ other backends with TUS/multipart/REST upload handlers and the most convenient features of each.
@visulima/storage-client	npm	The upload client library. Simple and easy file uploads for React | Vue | Solid | Svelte.

Terminal

Package	Version	Description
@visulima/ansi	npm	ANSI escape codes for some terminal swag.
@visulima/boxen	npm	Create beautiful boxes in the terminal with customizable borders, padding, and alignment.
@visulima/cerebro	npm	A delightful toolkit for building cross-runtime CLIs for Node.js, Deno, and Bun.
@visulima/colorize	npm	Terminal and Console string styling done right.
@visulima/command-line-args	npm	A mature, feature-complete library to parse command-line options.
@visulima/fmt	npm	Util.format-like string formatting utility.
@visulima/interactive-manager	npm	Interactive terminal output manager for spinners, progress bars, and dynamic updates
@visulima/is-ansi-color-supported	npm	Detect whether a terminal or browser supports ansi colors.
@visulima/progress-bar	npm	Terminal progress bars with multiple styles and multi-bar support
@visulima/spinner	npm	Minimal terminal spinners
@visulima/tabular	npm	Create beautiful ASCII tables and grids with customizable borders, padding, and alignment. Supports Unicode, colors, and ANSI escape codes.
@visulima/tui	npm	React-based TUI library powered by a native Rust diff engine, drop-in Ink-compatible API

Tooling

Package	Version	Description
@visulima/find-ai-runner	npm	Detect and invoke AI CLI tools (Claude, Gemini, Codex, Copilot, Cursor, Crush, Amp, Kimi, Qwen, OpenCode, Droid) installed on the system
@visulima/package	npm	A comprehensive package management utility that helps you find root directories, monorepos, package managers, and parse package.json, package.yaml, and package.json5 files with advanced features like catalog resolution.
@visulima/secret-scanner	npm	Fast secret and credential scanner — a Rust port of gitleaks detection, exposed via NAPI
@visulima/task-runner	npm	A task runner with caching support for monorepo workspaces
@visulima/task-runner-client	npm	Zero-dependency client for giving the @visulima/task-runner precise cache-correctness hints from inside a task
@visulima/tsconfig	npm	Find and/or parse the tsconfig.json file from a directory path.
@visulima/vis	npm	A monorepo dev toolkit — task runner, remote caching, security scanning, git hooks, and AI agent integrations — powered by @visulima/task-runner
@visulima/vis-mcp	npm	MCP (Model Context Protocol) server for @visulima/vis — exposes vis tooling to AI agents over stdio

Workflow

Package	Version	Description
@visulima/workflow	npm	A reusable, ESM-only, edge-ready durable workflow engine: code-first workflows with resumable steps, delays and external-event waits, backed by a pluggable store

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.

---