Blyp Docs

Blyp Logger

Grep less. Understand more.

Blyp is a high-performance logger built for Bun-first and Node-compatible TypeScript applications. It gives you one package that covers:

  • root application logging
  • standalone logger instances
  • framework-aware HTTP logging
  • browser-to-server log ingestion
  • structured BlypError handling
  • NDJSON file logging with rotation and archives

The GitHub repository is Blyphq/blyp, but the published package name is blyp-js.

What Blyp exports

AreaImport pathWhat you get
Core logger + errorsblyp-jslogger, createStandaloneLogger, createError, HTTP_CODES, parseError, readLogFile, config/runtime helpers
Browser loggerblyp-js/clientcreateClientLogger, browser-safe parseError, ClientLogger types
Framework adaptersblyp-js/<framework>createLogger() or equivalent framework factory plus framework-specific types
Workersblyp-js/workersinitWorkersLogger, createWorkersLogger, Workers-specific request logger types

Quick start

import { logger, createError } from "blyp-js";

logger.info("server started");
logger.success("cache warmed");

throw createError({
  status: 404,
  message: "User not found",
});

Supported integrations

  • blyp-js/elysia
  • blyp-js/expo
  • blyp-js/hono
  • blyp-js/express
  • blyp-js/fastify
  • blyp-js/nestjs
  • blyp-js/nextjs
  • blyp-js/tanstack-start
  • blyp-js/sveltekit
  • blyp-js/workers
  • Installation for package managers, peer dependencies, and exported subpaths.
  • Basic Usage for logger methods, child loggers, and standalone instances.
  • Errors for createError(), parseError(), and BlypError behavior.
  • Client for browser logging and /inngest ingestion.
  • Integrations for framework-specific guides.
  • Expo if you are shipping a mobile app and need remote client log sync from Expo.
  • Configuration for blyp.config.json, ignorePaths, and client ingestion config.
  • Type Surfaces for standalone, server-side, and browser-facing types.

On this page

No Headings