Troubleshooting

Check that the script URL points to your Reev instance and is accessible:

curl -I https://your-domain.com/reev.js

You should get a 200 response. If not, make sure you've run pnpm build and the public/reev.js file exists.

Enable debug mode to see what the tracker is sending:

window.ReevConfig = {
  projectId: "your-id",
  apiUrl: "https://your-domain.com",
  debug: true
};

Open the browser console and look for [Reev] log entries. Common causes:

• -Wrong projectId — check it matches the dashboard
• -Wrong apiUrl — must be the full origin (including protocol)
• -CORS error — the events endpoint should allow all origins by default

Popovers appear when frustration is detected (rage click, dead link, etc.). Make sure:

• -popover: true in your config (default)
• -You haven't exceeded maxPopovers for the session (default 3)
• -The popoverCooldown period has passed (default 30s)

The suggestion widget requires:

• -suggestions: true in your config
• -Flow suggestions enabled in the dashboard (Flows page → toggle on)
• -At least one active suggestion configured for the project

If you have demoSuggestions configured, the widget will use those as fallback when the API is unreachable.

Reports come from popover responses. If users haven't interacted with any popovers yet, the reports page will be empty. Check the events page to confirm the tracker is sending data.

Patterns are auto-generated when the same issue type occurs at least 2 times on the same page URL. Make sure:

• -There are ux_feedback events being sent (check the events endpoint)
• -Multiple feedback entries exist for the same page and issue type

The sitemap import requires:

• -A website_url configured in your project settings
• -A valid sitemap.xml at your site root (or referenced in robots.txt)
• -The sitemap must be publicly accessible from your Reev server

Verify your .env has the correct database URL:

DATABASE_URL=postgresql://user:password@host:5432/reev

Make sure PostgreSQL is running and the database exists. Run migrations with pnpm db:migrate.

Run the database migrations before building:

pnpm db:migrate

The events endpoint is rate-limited to 60 requests/minute per IP. The suggest endpoint is limited to 30 requests/minute per IP. If you're hitting limits in development, the rate limiter resets automatically after the time window.