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

OptionTypeDefaultDescription
projectIdstringYour project ID from the dashboard.
apiUrlstringBase URL of your Reev instance.

Detection

OptionTypeDefaultDescription
rageClickbooleantrueDetect rage clicks on buttons and links.
deadLinkbooleantrueScan for links that return 404.
brokenImagebooleantrueDetect images that fail to load.
formFrustrationbooleantrueDetect type-delete-retype patterns in form fields.

Popover

OptionTypeDefaultDescription
popoverbooleantrueShow contextual popovers when frustration is detected.
popoverThemestring"dark""dark" or "light" theme for the popover UI.
maxPopoversnumber3Maximum popovers shown per session.
popoverCooldownnumber30000Milliseconds between popovers.

Suggestions

OptionTypeDefaultDescription
suggestionsbooleanfalseEnable the navigation suggestion widget.
demoSuggestionsarray[]Fallback suggestions when the API is unreachable.

Other

OptionTypeDefaultDescription
debugbooleanfalseLog 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