Sawdust

Monorepo for @cues/sawdust — a runtime-agnostic logging + RUM toolkit for Node.js, the browser, and workers, built on LogLayer.

📖 Documentation: https://catesandrew.github.io/sawdust/

Packages

Package	Path	Description
@cues/sawdust	packages/core	Provider-agnostic core: façade, singleton, locators, request scope, console/pretty/consola transports.
@cues/sawdust-datadog	packages/datadog	Datadog provider: server + browser logs, RUM, APM trace injection.
@cues/sawdust-otel	packages/otel	OpenTelemetry logs provider — a transport that emits to the OTel Logs API.
@cues/sawdust-react	packages/react	React/Next integration — SSR-safe LoggerProvider, useLogger / useLoggerContext, DI helpers.
@cues/sawdust-angular	packages/angular	Angular integration — SSR-safe provideSawdustLogger, injectLogger, DI helpers.

Providers plug into core through the extraTransports / plugins seams — see the Providers guide.

Development

pnpm install          # install the whole workspace
pnpm build            # turbo: build every package
pnpm test             # turbo: run every package's tests
pnpm typecheck        # turbo: type-check every package
pnpm lint             # turbo: lint every package

Tooling: pnpm workspaces · Turborepo · Changesets · Biome · Vitest · TypeScript (NodeNext).

Releasing

Versioning and changelogs are managed by Changesets:

pnpm changeset        # record a change (bump level + summary)

The docs site lives in website/ and deploys to GitHub Pages via .github/workflows/deploy-docs.yml.