Beacon — Privacy-first web analytics for modern teams

Beacon is an SDK-E product. It measures site traffic without cookies, fingerprints, or personal data: a lightweight tracker, real-time dashboards, funnels, and a clean Data API.

• Hosted app: https://beacon.sdk.enterprises
• Tracker package: @sdk-e/beacon (packages/tracker)
• Docs: docs/architecture.md

Development

npm install
npm run dev            # dashboard at http://localhost:3000
npm run verify         # full gate (lint, typecheck, build, test)

Requires Node >= 22 and a local PostgreSQL for migrations (see .env.example).

Local services (email + Redis) for a full dev environment:

npm run dev:services   # mail sink (:1025 SMTP, :1080 API) + Upstash-compatible Redis (:8000)
npm run mail:list      # inspect captured email

Packages

Path	Package	Purpose
apps/web	@sdk-e/web	Next.js 16 dashboard + ingestion API
packages/tracker	@sdk-e/beacon	Zero-dependency analytics tracker

Agents: start with AGENTS.md.