Summary Maple is an OpenTelemetry observability platform structured as a monorepo, featuring a SPA frontend and an Effect-based backend API. It simplifies telemetry data collection and processing via an OTLP ingest gateway with key authentication and organization enrichment, for engineers and power users.

How It Works The project utilizes a monorepo managed by Bun and Turbo. It comprises a TanStack Router SPA frontend (Vite) and an Effect framework backend API, with Tinybird proxy integration. Telemetry data is ingested through an OTLP gateway handling auth, enrichment, forwarding. Deployments are orchestrated via Alchemy for Railway and Cloudflare, supporting prod, staging, PR envs.

Quick Start & Requirements

• Prerequisites: Bun >= 1.3.
• Installation: bun install.
• Development: All services: bun run dev:all. Strict: bun run dev:all:strict. Individual: bun run dev:web, bun run dev:api, bun run dev:ingest.
• Local Docker: docker compose -f docker-compose.yml up --build.
• Deployment: Full-stack: bun run deploy:prd, bun run deploy:stg, or PR_NUMBER=123 bun run deploy:pr.
• Tear Down: bun run destroy:prd, bun run destroy:stg, or PR_NUMBER=123 bun run destroy:pr.
• Links: No direct quick-start or demo links provided.

Highlighted Details

• Persistence: SQLite via libSQL for dashboard data. Local mode defaults to apps/api/.data/maple.db. Turso cloud mode via MAPLE_DB_URL/MAPLE_DB_AUTH_TOKEN. Self-hosting requires persisting .data directory. Migrations: bun run db:migrate, bun run db:generate.
• Ingest Keys: Manages per-org ingest keys (public/private) in DB, rerollable. Private keys encrypted at rest.
• Authentication: Supports clerk (Clerk integration, requires CLERK_SECRET_KEY/CLERK_PUBLISHABLE_KEY) and self_hosted (requires MAPLE_AUTH_MODE=self_hosted, MAPLE_ROOT_PASSWORD).

Maintenance & Community

• CI workflows in .github/workflows/ for prod, staging, PR previews. No community links or contributor details found.

Licensing & Compatibility

• License not specified.

Limitations & Caveats

• Breaking Change: Self-hosted JWT/API auth paths removed; MAPLE_ROOT_PASSWORD mandatory for self_hosted. Relies on Doppler for secrets; requires specific env vars.