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

# Widget Installation

> Add the Orova widget to your website

## Script tag

Add this to your HTML, just before the closing `</body>` tag:

```html theme={null}
<script
  src="https://app.orova.ai/widget/orova-widget.js"
  data-api-key="YOUR_API_KEY"
  data-agent-id="AGENT_ID"
  data-server-url="https://app.orova.ai"
  data-mode="voice"
></script>
```

### Required attributes

| Attribute         | Description                |
| ----------------- | -------------------------- |
| `data-api-key`    | Your Orova API key         |
| `data-agent-id`   | The agent ID to connect to |
| `data-server-url` | Your Orova API server URL  |

<Warning>
  All three required attributes must be set or the widget won't load.
</Warning>

## React / Next.js

```tsx theme={null}
export default function Layout({ children }) {
  return (
    <html>
      <body>
        {children}
        <script
          src="https://app.orova.ai/widget/orova-widget.js"
          data-api-key={process.env.NEXT_PUBLIC_OROVA_API_KEY}
          data-agent-id="AGENT_ID"
          data-server-url={process.env.NEXT_PUBLIC_OROVA_SERVER_URL}
          data-mode="voice"
        />
      </body>
    </html>
  );
}
```

## Vue

```html theme={null}
<template>
  <div id="app">
    <router-view />
  </div>
</template>

<script>
export default {
  mounted() {
    const script = document.createElement('script');
    script.src = 'https://app.orova.ai/widget/orova-widget.js';
    script.setAttribute('data-api-key', 'YOUR_API_KEY');
    script.setAttribute('data-agent-id', 'AGENT_ID');
    script.setAttribute('data-server-url', 'https://app.orova.ai');
    script.setAttribute('data-mode', 'voice');
    document.body.appendChild(script);
  }
}
</script>
```

## WordPress

Add the script tag to your theme's `footer.php` or use a plugin like "Insert Headers and Footers" to add it site-wide.

## Verify installation

Open your browser's developer console. You should see:

```
[Orova Widget] Initialized
```

If you see `Missing required attributes`, check that all three required attributes are set.
