DEV Community

Cover image for Read me of our Open Source Project | Litlyx
Antonio | CEO at Litlyx.com
Antonio | CEO at Litlyx.com

Posted on

Read me of our Open Source Project | Litlyx

🌐 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!

dashboard-litlyx

GitHub Repo stars

⭐️ Share some ❤️ and leave a Star on Our Repo

Github Open-Source Repo

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

Installation

You can install Litlyx using npm, yarn, or pnpm:

npm i litlyx
Enter fullscreen mode Exit fullscreen mode

Or import it directly into your JavaScript code:

<script defer data-project="project_id_here" src="https://cdn.jsdelivr.net/npm/litlyx/browser/litlyx.js"></script>
Enter fullscreen mode Exit fullscreen mode

Importing Litlyx with a direct script already tracks 10 KPIs such as page visits, browsers, devices, OS, real-time online users, and many more.

[!NOTE]

  • 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.

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!

technologies-supported-litlyx

Usage

Litlyx is very simple to use. The first thing is to import it into your code:

import { Lit } from 'litlyx';
Enter fullscreen mode Exit fullscreen mode

Once imported, you need to initialize Litlyx:

Lit.init('your_project_id');
Enter fullscreen mode Exit fullscreen mode

After this line, Litlyx will automatically track more than 10 KPIs for you.

[!NOTE]

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:

Lit.event('main_cta');
Enter fullscreen mode Exit fullscreen mode

This is the minimal setup for an event. If you want more control over them, you can use the metadata field:

Lit.event('pretty_cool_event', {
  metadata: {
    'tag': 'litlyx is awesome!',
    'age': 27,
    'score': 100.01,
    'list': ['Hello', 'World!']
  }
});
Enter fullscreen mode Exit fullscreen mode

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

chat-ai-data-analyst-litlyx

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.

⭐️ Share some ❤️ and leave a Star on Our Repo

Github Open-Source Repo

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.

Contact

Write to us at helplitlyx@gmail.com if you need to contact us.

License

Litlyx is licensed under the Apache 2.0 license.

⭐️ Share some ❤️ and leave a Star on Our Repo

Github Open-Source Repo

Top comments (0)