Lensflare

Lensflare is a local observability workspace for inspecting logs and traces while you build. It includes a web UI, a local server, a desktop app, and a small Effect SDK that sends development telemetry to your local Lensflare dataset.

Quick Start

Install dependencies:

pnpm install

Run the local server and web app:

pnpm dev

Run the desktop app:

pnpm dev:desktop

Build and test:

pnpm build
pnpm test

Effect SDK

The first public package is @lensflare.dev/effect, an Effect layer for sending logs and traces to Lensflare during local development.

pnpm add effect @lensflare.dev/effect

import { Effect } from "effect";
import { Lensflare } from "@lensflare.dev/effect";

const program = Effect.gen(function* () {
  yield* Effect.log("hello from Lensflare");
});

Effect.runPromise(program.pipe(Effect.provide(Lensflare.layer("dev"))));

See packages/effect for package documentation.

Development

This repository uses Node 24 and pnpm 10. The main workspace commands are:

pnpm dev
pnpm dev:web
pnpm dev:server
pnpm dev:desktop
pnpm check
pnpm typecheck
pnpm test
pnpm build

Before writing Effect code, consult the local Effect guidance described in AGENTS.md.

Releases

Desktop app releases are published through GitHub Releases. Package releases are managed with Changesets and published to NPM.

• GitHub Releases
• Contributing
• Security
• License