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
- structured request batches
- framework-aware HTTP logging
- browser-to-server log ingestion
- structured
BlypErrorhandling - NDJSON file logging with rotation and archives
- database-backed primary logging with Prisma and Drizzle adapters
Studio
Blyp includes a local developer UI called Studio, launched via the CLI. Studio runs at http://localhost:3003 and lets you inspect your project, work with logs, and manage AI assistant workflows tied to your codebase.
To launch it:
blyp studioSee the CLI docs for full Studio usage.
Blyp also now has a separate CLI project for local developer workflows, documented in Blyphq/cli as @blyp/cli with the blyp command.
What Blyp exports
| Area | Import path | What you get |
|---|---|---|
| Core logger + errors | @blyp/core | logger, createStandaloneLogger, createStructuredLog, createError, HTTP_CODES, parseError, readLogFile, config/runtime helpers |
| Browser logger | @blyp/core/client | createClientLogger, browser-safe parseError, ClientLogger types |
| Database adapters | @blyp/core/database | createPrismaDatabaseAdapter, createDrizzleDatabaseAdapter, and database config types |
| Connector helpers | @blyp/core/betterstack, @blyp/core/posthog, @blyp/core/sentry, @blyp/core/otlp | manual connector loggers, structured connector helpers, and provider-specific exception capture |
| Framework adapters | @blyp/core/<framework> | createLogger() or equivalent framework factory plus framework-specific types |
| Workers | @blyp/core/workers | initWorkersLogger, createWorkersLogger, Workers-specific request logger types |
Quick start
bun add @blyp/coreThe published npm package is
@blyp/core. The project, org, and tooling all use the name Blyp.
import { logger, createError } from "@blyp/core";
logger.info("server started");
logger.success("cache warmed");
throw createError({
status: 404,
message: "User not found",
});Supported integrations
@blyp/core/elysia@blyp/core/expo@blyp/core/hono@blyp/core/express@blyp/core/fastify@blyp/core/nestjs@blyp/core/nextjs@blyp/core/tanstack-start@blyp/core/sveltekit@blyp/core/workers
Recommended reading order
- Installation for package managers, peer dependencies, and exported subpaths.
- CLI for the
blypcommand, Studio launch flow, health checks, and skill installation. - Basic Usage for logger methods, child loggers, and standalone instances.
- Database Logging for
destination: "database", Prisma and Drizzle adapters, delivery, and CLI-assisted schema setup. - Structured Logs for
createStructuredLog(), typed fields, and request-scoped batch emission. - Errors for
createError(),parseError(), andBlypErrorbehavior. - Skills for copy-pasteable AI agent presets that help tools install and wire Blyp correctly.
- Integrations for browser, framework, and runtime-specific guides.
- Connectors for Better Stack, PostHog, Sentry, OTLP, and client/expo forwarding.
- Client for browser logging and
/inngestingestion. - Expo if you are shipping a mobile app and need remote client log sync from Expo.
- Configuration for
blyp.config.*, connector setup,ignorePaths, and client ingestion config. - Type Surfaces for standalone, server-side, and browser-facing types.