# Litlyx

> Open-source, cookie-free analytics tool with an AI-powered dashboard that installs in 30 seconds and supports self-hosting via Docker or a managed cloud.

Litlyx is a fast, modern, and fully cookie-free analytics platform built as an open-source alternative to Google Analytics 4, Mixpanel, Plausible, Umami, and Matomo. It is licensed under Apache 2.0, written primarily in TypeScript, and can be deployed in under 30 seconds via a single script tag or npm package. The project supports both a managed cloud version at dashboard.litlyx.com and full self-hosting via Docker Compose.

## What It Is

Litlyx is a web analytics and event-tracking tool designed for developers who want lightweight, privacy-respecting insights without cookie banners or complex configuration. The core platform tracks page visits, real-time users, unique visitors, and custom events out of the box. An AI-powered dashboard surfaces this data in a simple, visual interface. The README positions it as a GDPR-compliant alternative to heavier analytics stacks.

## Framework and Integration Support

Litlyx works with all modern JavaScript and TypeScript frameworks. The README explicitly lists compatibility with React, Next.js, Vue, Nuxt, Angular, and Node.js, and notes that WordPress sites can integrate via a third-party script-injection plugin. Installation is available through npm, pnpm, or any modern package manager, as well as a CDN script tag for zero-build setups.

## Custom Event Tracking

Beyond automatic page-view tracking, Litlyx exposes a simple `Lit.event()` API for custom events. Developers can attach structured metadata — such as product names, prices, and currencies — to any event, making it adaptable to e-commerce, SaaS funnels, or any instrumentation use case. Events can also be fired directly via a REST API endpoint using cURL, enabling server-side and backend tracking without a JavaScript client.

## Self-Hosting Architecture

The self-hosted deployment uses Docker Compose and runs the full Litlyx dashboard locally at `localhost:3000`. The README describes a two-command setup (`npm run docker-prepare` followed by `docker-compose up`). Self-hosters can point the browser script to their own instance by configuring `data-host`, `data-port`, and `data-secure` attributes. The project states that self-hosting gives access to the full platform for free, with optional lifetime plans available for teams that need to scale to more client seats.

## Update: v0.0.19 — New Self-Hosting & Open-Source Release

The latest GitHub release, v0.0.19 published on December 1, 2025, is titled "New Self-hosting & Open-Source Release," signaling a significant milestone in the project's open-source and self-hosting story. The repository was last pushed to in December 2025 and continues to receive updates, with 1,741 stars and 113 forks recorded on GitHub. A public roadmap is available at litlyx.com/roadmap for tracking upcoming development.

## Features
- Cookie-free analytics
- AI-powered dashboard
- Real-time user tracking
- Page visit tracking
- Unique visitor tracking
- Custom event tracking with metadata
- REST API event ingestion
- Self-hosting via Docker Compose
- Managed cloud option
- GDPR compliant
- 30-second setup
- CDN script tag installation
- npm/pnpm package support
- Public roadmap

## Integrations
React, Next.js, Vue, Nuxt, Angular, Node.js, WordPress, npm, pnpm, Docker

## Platforms
LINUX, WEB, API, CLI

## Pricing
Open Source

## Version
v0.0.19

## Links
- Website: https://litlyx.com
- Documentation: https://docs.litlyx.com
- Repository: https://github.com/Litlyx/litlyx
- EveryDev.ai: https://www.everydev.ai/tools/litlyx
