> For the complete documentation index, see [llms.txt](https://userlens.gitbook.io/userlens-analytics/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://userlens.gitbook.io/userlens-analytics/getting-started/react.md).

# React

Integrate the Userlens SDK into your React application.

## Installation

```bash
npm install userlens-analytics-sdk
```

## Choose Your Setup

|                     | Client-Side Setup | Proxy Setup                        |
| ------------------- | ----------------- | ---------------------------------- |
| **Best for**        | Most applications | Apps needing ad blocker resistance |
| **Backend changes** | None              | Required                           |
| **Setup time**      | \~5 minutes       | \~15 minutes                       |

{% content-ref url="/pages/xkVDRfwb31QT0DHPoXQo" %}
[Client-Side Setup](/userlens-analytics/getting-started/react/client-side.md)
{% endcontent-ref %}

Events go directly from the browser to Userlens. Quick to set up, no backend changes needed.

{% content-ref url="/pages/BqBKKTsAmdDUQzGo7jew" %}
[Proxy Setup](/userlens-analytics/getting-started/react/proxy.md)
{% endcontent-ref %}

Events flow through your backend first. Use this if you need to avoid ad blockers.