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
- AI tracing across Better Agent, Vercel AI SDK, OpenAI, Anthropic, and OpenRouter-compatible clients
- browser-to-server log ingestion
- structured
BlypErrorhandling - NDJSON file logging with rotation and archives
- database-backed primary logging with Prisma and Drizzle adapters
Stability
| Area | Tier | Guarantee |
|---|---|---|
Core logger API (logger.*, createStructuredLog, createError) | Stable | No breaking changes without a major version bump |
Framework adapters (@blyp/core/hono, /nextjs, etc.) | Stable | Same guarantee |
| Connector APIs | Stable | Same guarantee |
| Studio UI | Beta | May change between minor versions |
| CLI commands | Beta | Commands may be added or changed in a minor version |
| Internal APIs / unexported symbols | Unstable | No guarantees |
For the full compatibility policy, deprecation window, and Bun vs Node support contract, see Blyphq/blyp/STABILITY.md. For vulnerability disclosure and maintainer response expectations, see Blyphq/blyp/SECURITY.md.
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:
bunx @blyp/cli 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 |
| AI tracing | @blyp/core/ai/better-agent, @blyp/core/ai/vercel, @blyp/core/ai/openai, @blyp/core/ai/anthropic, @blyp/core/ai/fetch | Better Agent plugins and manual trackers, middleware, model wrappers, provider wrappers, transport tracing, and AI trace types |
| Database adapters | @blyp/core/database | createPrismaDatabaseAdapter, createDrizzleDatabaseAdapter, and database config types |
| Connector helpers | @blyp/core/betterstack, @blyp/core/posthog, @blyp/core/databuddy, @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/react-router@blyp/core/tanstack-start@blyp/core/solid-start@blyp/core/sveltekit@blyp/core/astro@blyp/core/nuxt@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.
- Configuration for
blyp.config.*, connector setup,ignorePaths, and client ingestion config. - Database for required schemas, Prisma and Drizzle adapters, delivery, and CLI-assisted setup.
- Schema Contract for the required
blyp_logstable, indexes, and naming contract. - AI for AI tracing concepts, provider coverage, and request-scoped correlation.
- AI Tracing for setup with Better Agent, Vercel AI SDK, OpenAI, Anthropic, OpenRouter, and low-level fetch tracing.
- Working With Blyp for grouped development and production guides.
- Production for deployment guidance covering durability, flush boundaries, connectors at scale, and serverless runtimes.
- Request Tracing for
x-blyp-trace-id, browser correlation, and end-to-end trace propagation. - 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, Databuddy, 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. - Troubleshooting for Studio connection problems, missing logs, connector auth issues, file logging failures, and TypeScript import errors.
- Type Surfaces for standalone, server-side, and browser-facing types.