commit 2b185a9db506ce96e3df010071110d62812261ad Author: Litlyx Date: Thu May 30 22:31:03 2024 +0200 first commit diff --git a/LICENSE.md b/LICENSE.md new file mode 100644 index 0000000..17a6f93 --- /dev/null +++ b/LICENSE.md @@ -0,0 +1,7 @@ +Copyright 2024 Litlyx + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You can read the License at + + https://www.apache.org/licenses/LICENSE-2.0 diff --git a/assets/agent.png b/assets/agent.png new file mode 100644 index 0000000..adbb6b6 Binary files /dev/null and b/assets/agent.png differ diff --git a/assets/bg.png b/assets/bg.png new file mode 100644 index 0000000..7517517 Binary files /dev/null and b/assets/bg.png differ diff --git a/assets/screen.png b/assets/screen.png new file mode 100644 index 0000000..2e99fe1 Binary files /dev/null and b/assets/screen.png differ diff --git a/assets/techs.png b/assets/techs.png new file mode 100644 index 0000000..9c6c9e6 Binary files /dev/null and b/assets/techs.png differ diff --git a/readme.md b/readme.md new file mode 100644 index 0000000..0ca6c1b --- /dev/null +++ b/readme.md @@ -0,0 +1,137 @@ + +

+ +

+ +

+🌐 Website 📚 Docs 🔥 Start for Free! +

+ +
+ +# + +

+ A single-line code analytics solution that integrates with every JavaScript/TypeScript framework.
+ Track 10+ KPIs and as many custom events as you want for your website or web app.
+ An AI Data Analyst Assistant ready to help you! +

+ +# + +
+ +

+ +

+ +# + +![GitHub Repo stars](https://img.shields.io/github/stars/Litlyx/litlyx) +![NPM Version](https://img.shields.io/npm/v/litlyx?logo=npm&color=orange) +![npm bundle size](https://img.shields.io/bundlephobia/min/litlyx) + +# + +# Join Litlyx's Community Channel on Discord + +If you need more information, help, or want to provide general feedback, feel free to join us here: [Litlyx on Discord](https://litlyx.com) + +# Installation + +You can install Litlyx using `npm`, `yarn`, or `pnpm`: + +```sh +npm i litlyx +``` + +Or import it directly into your JavaScript code: + +```html + +``` + +Importing Litlyx with a direct script already tracks 10 KPIs such as page visits, browsers, devices, OS, real-time online users, and many more. + +> - [!WARNING] +> - If you want to track custom events, you need to import the library with `npm`, `yarn`, or `pnpm`. Continue reading to find out more! + +#### You can find the official documentation: [here](https://docs.litlyx.com). + +# Supported Frameworks + +Litlyx natively supports all these JavaScript/TypeScript frameworks. You can use Litlyx in all WordPress projects by injecting JS code using plugins. You can even use Litlyx in cloud (or edge) functions in BaaS! + +

+ +

+ +# Usage + +Litlyx is very simple to use. The first thing is to import Litlyx into your code: + +```js +import { Lit } from 'litlyx'; +``` + +Once imported, you need to initialize Litlyx: + +```js +Lit.init('your_project_id'); +``` + +After this line, Litlyx will automatically track more than 10 KPIs for you. + +> [!NOTE] +> - Create your first project for free! 👉 Create now! + +# Customize Your Experience by Tracking Custom Events + +With Litlyx, you can create your own events to track in your project on the main CTA. Your creativity is the limit! Customize your experience like this: + +```js +Lit.event('main_cta'); +``` + +This is the minimal setup for an event. If you want more control over them, you can use the `metadata` field: + +```js +Lit.event('pretty_cool_event', { + metadata: { + 'tag': 'litlyx is awesome!', + 'age': 27, + 'score': 100.01, + 'list': ['Hello', 'World!'] + } +}); +``` + +And that's it! You have set up your first custom event. From now on, you know how to set them up. + +# Lit, the AI Data Analyst at Your Service + +

+ +

+ +Litlyx comes with an integrated AI that can analyze your collected data and your entire history. It can compare data, query specific metadata, visualize charts, and much more. + +You can have a `conversation` with Lit in the dashboard 👉 [here](https://dashboard.litlyx.com). + +# You Are Free to Self-Host Litlyx + +Litlyx is completely open-source, and you are free to self-host it and create your own version of the dashboard. We are always open to conversations with all contributors to the project, so contact us at `helplitlyx@gmail.com` to schedule a call with us! + +We hope to hear from you! + +# Official Docs + +Read the complete documentation at [https://docs.litlyx.com](https://docs.litlyx.com). + +# Contact + +Write to us at `helplitlyx@gmail.com` if you need to contact us. + +# License + +Litlyx is licensed under the [Apache 2.0](/LICENSE.md) license. \ No newline at end of file