Configuration
All options are passed via window.ReevConfig. Everything has sensible defaults.
Full example
window.ReevConfig = {
// Required
projectId: "your-project-id",
apiUrl: "https://your-domain.com",
// Detection toggles
rageClick: true,
deadLink: true,
brokenImage: true,
formFrustration: true,
// Popover
popover: true,
popoverTheme: "dark", // "dark" | "light"
maxPopovers: 3, // per session
popoverCooldown: 30000, // ms between popovers
// Suggestion widget
suggestions: true,
// Debug
debug: false,
};Options reference
Required
| Option | Type | Default | Description |
|---|
projectId | string | — | Your project ID from the dashboard. |
apiUrl | string | — | Base URL of your Reev instance. |
Detection
| Option | Type | Default | Description |
|---|
rageClick | boolean | true | Detect rage clicks on buttons and links. |
deadLink | boolean | true | Scan for links that return 404. |
brokenImage | boolean | true | Detect images that fail to load. |
formFrustration | boolean | true | Detect type-delete-retype patterns in form fields. |
Popover
| Option | Type | Default | Description |
|---|
popover | boolean | true | Show contextual popovers when frustration is detected. |
popoverTheme | string | "dark" | "dark" or "light" theme for the popover UI. |
maxPopovers | number | 3 | Maximum popovers shown per session. |
popoverCooldown | number | 30000 | Milliseconds between popovers. |
Suggestions
| Option | Type | Default | Description |
|---|
suggestions | boolean | false | Enable the navigation suggestion widget. |
demoSuggestions | array | [] | Fallback suggestions when the API is unreachable. |
Other
| Option | Type | Default | Description |
|---|
debug | boolean | false | Log tracker events to the browser console. |
Dashboard settings
Some settings are controlled from the dashboard UI rather than the script config:
- •Flow suggestions — enable/disable, display mode (frustration / always), widget position, theme
- •Project URL — used for sitemap import and link validation
- •Auto-discover — automatically generate flow suggestions from user navigation patterns