Official JavaScript SDKs for LogTide — self-hosted log management with distributed tracing, error capture, and breadcrumbs for every major framework.
| Package | Version | Description |
|---|---|---|
@logtide/types |
Shared type definitions | |
@logtide/core |
Core client, hub, transports, and utilities | |
@logtide/express |
Express middleware | |
@logtide/fastify |
Fastify plugin | |
@logtide/nextjs |
Next.js integration (App Router & Pages) | |
@logtide/nuxt |
Nuxt 3 module with Nitro hooks | |
@logtide/sveltekit |
SvelteKit hooks integration | |
@logtide/hono |
Hono middleware | |
@logtide/angular |
Angular ErrorHandler, HTTP Interceptor | |
@logtide/elysia |
Elysia 1.4 plugin + Elysia 2 preview via /next |
|
@logtide/browser |
Browser SDK — Web Vitals, breadcrumbs, offline transport | |
@logtide/cli |
CLI — source maps upload and release management | |
@logtide/sdk-node |
Legacy Node.js SDK (use @logtide/express or @logtide/fastify instead) |
Every framework package follows the same pattern — pass your DSN and service name:
# Install for your framework npm install @logtide/express # Express npm install @logtide/fastify # Fastify npm install @logtide/nextjs # Next.js npm install @logtide/nuxt # Nuxt 3 npm install @logtide/sveltekit # SvelteKit npm install @logtide/hono # Hono npm install @logtide/angular # Angular npm install @logtide/elysia # Elysia
// Every integration follows the same pattern: { dsn: 'https://[email protected]', service: 'my-app', } // Or use apiUrl + apiKey separately: { apiUrl: 'https://your-logtide-instance.com', apiKey: 'lp_your_key', service: 'my-app', }
See each package's README for framework-specific setup instructions.
The @logtide/cli package provides a command-line tool for managing source maps and releases.
# Install globally npm install -g @logtide/cli # Or use npx npx @logtide/cli sourcemaps upload --api-url https://your-logtide-instance.com --api-key lp_your_key ./dist
| Command | Description |
|---|---|
logtide sourcemaps upload |
Upload source maps to LogTide server for stack trace deobfuscation |
@logtide/types ← Shared TypeScript interfaces
↓
@logtide/core ← Client, Hub, Scope, Transports, Integrations
↓
├── @logtide/express ← Express middleware
├── @logtide/fastify ← Fastify plugin
├── @logtide/nextjs ← Next.js (App Router + Pages)
├── @logtide/nuxt ← Nuxt 3 (Nitro + Vue)
├── @logtide/sveltekit ← SvelteKit (handle/handleError/handleFetch)
├── @logtide/hono ← Hono middleware
├── @logtide/angular ← Angular (ErrorHandler + HttpInterceptor)
├── @logtide/elysia ← Elysia 1.4 plugin + Elysia 2 /next export
├── @logtide/browser ← Browser SDK (Web Vitals, breadcrumbs, offline)
├── @logtide/cli ← CLI (source maps upload)
└── @logtide/sdk-node ← Legacy standalone Node.js SDK
All framework packages share @logtide/core for:
- Distributed tracing (W3C Trace Context /
traceparent) - Error serialization with structured stack traces
- Breadcrumbs for navigation, HTTP, console, and custom events
- Batched transport with retry logic and circuit breaker
- Scope isolation per request
# Install dependencies pnpm install # Build all packages pnpm build # Run all tests pnpm test # TypeScript check pnpm typecheck # Set version across all packages pnpm version:set 0.6.0
feature/* ──> develop ──> main ──> tag v*.*.* ──> npm publish
hotfix/* ──> main (direct, for urgent fixes)
See .github/BRANCH_PROTECTION.md for full details.
Contributions are welcome! Please open an issue or submit a pull request.
MIT License — see LICENSE for details.