Quick start

Visit the home page and sign in. After sign-in, open the dashboard — your account is ready on first visit.

If you have no projects yet, you are guided to New project. Enter a name and submit. You land on project Overview settings with your project ID and API token ready.

Open Settings → API keys for your project (or Integration for the full copy-paste flow). Copy:

• Project ID
• Bearer token (keep secret — treat like a password)
• Base URL — your public LoggerMan app origin (e.g. production URL, Vercel preview, or tunnel URL for local dev)

# .env.local (your app — LoggerMan Cloud)
LOGGERMAN_PROJECT_ID=your_project_id
LOGGERMAN_TOKEN=your_bearer_token
LOGGERMAN_BASE_URL=https://loggerman.dev

# Self-hosted: use your deployment origin — see /docs/self-hosted

Pick one of two integration options:

• npm (recommended) — npm install @marvink02/loggerman-sdk
• Copy a file — paste loggerman.ts from Integration settings (no package manager)

npm install @marvink02/loggerman-sdk

import { createLogger } from "@marvink02/loggerman-sdk";

const logger = createLogger({
  projectId: process.env.LOGGERMAN_PROJECT_ID!,
  token: process.env.LOGGERMAN_TOKEN!,
  baseUrl: process.env.LOGGERMAN_BASE_URL!,
  source: "my-api",
});

await logger.info("Server listening on port 3000");

await logger.error("Database connection failed", {
  host: process.env.DB_HOST,
  attempt: 3,
});

In the dashboard, go to Settings → Integration and click Send test log. Then open Logs in the sidebar — your entry should appear within seconds.

Store credentials in your host's secret manager. Use distinct source values per service (e.g. api, worker, web) so filters in the dashboard stay meaningful.