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

# Setup

<Tabs>
  <Tab title="React / Next.js">
    <Steps>
      <Step title="Import the VeltCursor Component">
        Import the `VeltCursor` component.

        ```js theme={null}
        import { VeltProvider, VeltCursor } from '@veltdev/react'
        ```
      </Step>

      <Step title="Add the VeltCursor Component">
        Add the `VeltCursor` component to the root of your app.

        ```js theme={null}
        <VeltProvider apiKey="API_KEY">
              <VeltCursor />
              {/* ... */}
        </VeltProvider>
        ```

        This component renders the cursors of users on the same document and location in your web app.

        <Info>
          Note that we automatically assign different colors to users & adapt the cursors to different screen sizes and to what's actually present on the screen. So you don't have to worry about building this logic.
        </Info>
      </Step>

      <Step title="Test Integration">
        Test it out by opening the target page in two browsers (with one in incognito) with two different users logged in.

        You should see the cursors of the users rendered as you move mouse around.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Other Frameworks">
    <Steps>
      <Step title="Place the <velt-cursor> component">
        Add the `<velt-cursor>` component to the root of your app.

        ```html theme={null}
        <body>
          <velt-cursor></velt-cursor>
        </body>
        ```

        This component renders the cursors of users on the same document and location in your web app.

        <Info>
          Note that we automatically assign different colors to users & adapt the cursors to different screen sizes and to what's actually present on the screen. So you don't have to worry about building this logic.
        </Info>
      </Step>

      <Step title="Test Integration">
        Test it out by opening the target page in two browsers (with one in incognito) with two different users logged in.

        You should see the cursors of the users rendered as you move mouse around.
      </Step>
    </Steps>
  </Tab>
</Tabs>

<RequestExample>
  ```js React / Next.js theme={null}
  import { VeltProvider, VeltCursor } from '@veltdev/react';

  export default function App() {

    return (
      <VeltProvider apiKey="API_KEY">
        <VeltCursor />
        {/* ... */}
      </VeltProvider>
    );
  }
  ```

  ```js HTML theme={null}
  <!DOCTYPE html>
  <html lang="en">
    <head>
      <title>Cursors documentation</title>
    </head>
    <body>
      <velt-cursor></velt-cursor>
    </body>
  </html>

  ```
</RequestExample>
