> ## Documentation Index
> Fetch the complete documentation index at: https://docs.litlyx.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Next.js
> Learn how to track your first visit & event using Next.js.
## Pre-Requisites
Before proceeding, ensure you:
Get started [here](https://nextjs.org/)
Sign up on [Litlyx Dashboard](https://dashboard.litlyx.com/) and create a new workspace.
## 1. Install
Choose your package manager & install the library.
```bash npm theme={null}
npm install litlyx-js
```
```bash yarn theme={null}
yarn add litlyx-js
```
```bash pnpm theme={null}
pnpm add litlyx-js
```
```bash bun theme={null}
bun install litlyx-js
```
## 2. Import
Now import litlyx in your `entry-point` file. Normally in Next, you can add this in `layout.tsx`.
```javascript javascript theme={null}
import { Lit } from "litlyx-js"
```
Don't forget to add `use client` over the imports
## 3. Initialize
Next, initialize Litlyx library with your workspace in your entry-point file as follow:
```javascript javascript theme={null}
export default function RootLayout({
children,
}: Readonly<{
children: React.ReactNode;
}>) {
Lit.init("workspace_id");
return (
{children}
);
}
```
This line of code will immediately start collecting web analytics such as: `Page Visits`, `Real-Time Users`, `Referrers`, `Bounce Rate`, `Countries`, `Unique Visitor Sessions`, `OS` & `Devices`.
## 4. Collect Custom Events
To customize your experience, add the following line in each function you desire. There is no limit to the number of events.
```javascript javascript theme={null}
Lit.event("your_event_name");
```
If you want to exercise more control over your events, you can use the `metadata` field.
```javascript javascript theme={null}
Lit.event("your_event_name", metadata: {
'type': 'MAIN_CTA',
'priority': 0.9
});
```
In practice, let's try to trigger an event:
```javascript javascript theme={null}
Lit.event("click-button")}>
button name
```
In your dashboard, you can group them in the `Events` tab with the `Event Metadata Analyzer`.