> ## Documentation Index
> Fetch the complete documentation index at: https://lifters.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# JavaScript SDK Overview

> The Atlas JavaScript SDK — inject into your frontend to automatically capture user behavior and session data.

<Info>
  The Atlas JavaScript SDK is under development. This page describes the planned
  API surface. [Join the waitlist](https://app.atlas.io/waitlist/sdk) to be notified.
</Info>

## What the SDK Does

The `@atlas-platform/sdk` JavaScript package is designed to be injected into your **frontend** (web application) to automatically capture:

* Page views and navigation events
* Session duration and activity
* UI interactions (bet slip opens, game launches, etc.)
* Frontend performance metrics

This complements the **backend Events API**, which captures financial and operational events.

## Backend vs Frontend Events

|              | Backend Events API          | Frontend SDK                |
| ------------ | --------------------------- | --------------------------- |
| **Where**    | Your server                 | Player's browser            |
| **What**     | Bets, deposits, settlements | Clicks, page views, session |
| **Auth**     | API Key (secret)            | Public write-only token     |
| **Latency**  | Configurable                | Real-time                   |
| **Use case** | Financial/compliance data   | UX and behavioral analytics |

## Planned Installation

```bash theme={null}
npm install @atlas-platform/sdk
```

Or via CDN:

```html theme={null}
<script src="https://cdn.twinfo.io/atlas.min.js"></script>
```

## Planned Usage

```javascript theme={null}
import Atlas from '@atlas-platform/sdk';

const atlas = new Atlas({
  publicKey: 'atl_pub_xxxxxxxxxxxxxxxx',
  brandId: 'brand_xyz',
});

// Auto-captures page views, sessions
atlas.init();

// Manual event tracking
atlas.track('bet_slip_opened', {
  sport: 'football',
  market: 'Match Winner',
});

// Identify user after login
atlas.identify('user_12345', {
  plan: 'standard',
  country: 'BR',
});
```

## Stay Updated

* [Platform Status](https://status.atlas.io)
* [Changelog](/introduction/changelog)
* [Contact](mailto:platform@atlas.io)