Possible Causes:

• SDK not properly initialized
• Incorrect integration code
• CORS issues blocking API requests
• Network connectivity problems
• API URL misconfigured

Solutions:

1. Verify the SDK script tag is present in your HTML
2. Check browser console for errors
3. Verify data-integration-code matches your integration code
4. Ensure NEXT_PUBLIC_API_URL is set correctly
5. Check CORS settings on your backend
6. Verify network tab shows successful API requests

Check:

• SDK file path is correct (/sdks/sublyzer.js)
• File exists in public/ directory
• No JavaScript errors in console
• Script tag is placed before closing </body> tag

// Verify SDK is loaded
console.log(typeof Sublyzer !== 'undefined' ? 'SDK loaded' : 'SDK not found');

If you see CORS errors in the browser console:

// Backend CORS configuration (NestJS example)
app.enableCors({
  origin: ['http://localhost:3000', 'https://yourdomain.com'],
  credentials: true,
});

Ensure your frontend URL is included in the CORS allowed origins.

If events are duplicated:

• Check for multiple SDK script tags
• Ensure click handlers guard against event bubbling
• Verify SDK is not initialized multiple times
• Check for React StrictMode double-rendering in development

Verify:

• Performance API is available (window.performance)
• Core Web Vitals are supported in the browser
• Page has fully loaded before checking metrics
• No ad blockers interfering with performance APIs

Common Problems:

• OAuth redirect error: Verify redirect URI matches GitHub app settings
• No repositories listed: Check GitHub permissions include repo access
• Auto-Patch not working: Ensure repository has write access enabled
• Commit not appearing: Check GitHub webhook settings and permissions

Troubleshooting Steps:

1. Verify GitHub integration is connected
2. Check repository has accessible code
3. Ensure test depth is not too high (start with 3-5)
4. Review test logs in the dashboard
5. Check API rate limits haven't been exceeded

If your issue is specifically about browser agents (videos/logs/timer), see TestingAI.

If you're still experiencing issues:

• Check the browser console for error messages
• Review API response status codes in Network tab
• Verify environment variables are set correctly
• Join our Discord community for support
• Review the API Reference for endpoint details