Litlyx

Litlyx is a lightweight, privacy‑first analytics platform designed for developers who need quick insight without the overhead of cookies or intrusive tracking. Built on a modern JavaScript stack, it exposes a simple yet powerful API that can be dropped into any web project—whether it’s a vanilla site, a React/Next.js app, or a WordPress installation via a plugin. The core of Litlyx tracks standard KPIs such as visits, unique visitors, real‑time online users, and bounce rate out of the box while also allowing custom event tracking with rich metadata.

Key Features

• Cookie‑free: All data is sent without storing any client‑side cookies, ensuring full GDPR compliance out of the box.
• Universal SDK: A single litlyx-js package works across browsers, Node.js, and popular frameworks (React, Vue, Svelte).
• Custom events: Developers can fire arbitrary events (Lit.event('checkout', { metadata })) and enrich them with structured data.
• Real‑time dashboard: The self‑hosted UI, running on Node/Express, visualises visits and events in real time, with optional AI insights via the public API.
• Self‑hosted & Docker: A docker-compose.yml is included; the dashboard and event broker run in separate containers, making deployment as simple as docker‑compose up.

Technical Stack

Core Capabilities

• Project‑based isolation: Each project has its own ID; the SDK uses data-project or Lit.init(id) to namespace events.
• REST API: /event endpoint accepts raw JSON payloads, enabling server‑side event injection or integration with third‑party services.
• Webhooks: Projects can register URLs to receive event notifications for custom workflows (e.g., trigger a Slack message on a high‑value purchase).
• Metadata schema: Arbitrary key/value pairs are stored per event; the dashboard automatically aggregates numeric fields for charts.
• Real‑time analytics: Socket.IO streams live visitor counts and event streams to the UI, allowing instant dashboards.

Deployment & Infrastructure

• Self‑hosting: A single docker-compose.yml brings up the broker, dashboard, and PostgreSQL.
• Scalability: Stateless Node.js services can be replicated behind a load balancer; PostgreSQL can be upgraded to a managed cluster for larger workloads.
• Environment variables: HOST, PORT, DB_URL, and JWT_SECRET configure the stack; secrets can be injected via Docker secrets or Kubernetes ConfigMaps.
• Data retention: Events are stored in raw form for 30 days, after which they’re aggregated and purged to keep storage lean.

Integration & Extensibility

• Plugin system: The dashboard exposes a plugin API; developers can write React components that tap into the event stream or add new visualizations.
• SDK hooks: The litlyx-js package allows intercepting the event queue to add custom logic (e.g., rate limiting or conditional tracking).
• API keys: Each project receives a unique key; this can be embedded in front‑end code or used server‑side for secure event injection.
• Webhooks: Register callbacks for specific event types, enabling downstream processing (CRM syncs, notification services).

Developer Experience

• Documentation: The official docs (https://docs.litlyx.com) cover SDK usage, API endpoints, and deployment guides with clear examples.
• Community: A Discord channel offers real‑time support; the GitHub repo has over 1.5k stars and active issue tracking.
• Configuration: No complex dashboards or multi‑tenant setup; a single config file (docker-compose.yml) is sufficient for most use cases.
• Testing: The SDK ships with TypeScript typings, and the backend exposes a Swagger UI for quick API exploration.

Use Cases

1. Privacy‑centric websites: Blogs or e‑commerce sites that must avoid cookies yet need basic traffic analytics.
2. Developer portals: Projects that want to expose real‑time visitor stats without a full analytics stack.
3. Internal dashboards: Companies that require custom event tracking (e.g., feature usage) integrated with their own infrastructure.
4. Rapid prototyping: MVPs that need analytics quickly; the 30‑second setup lets teams iterate without waiting for a full GA implementation.

Advantages Over Alternatives