Skip to main content

GitHub Integration

Connect your repository to DebuggAI in 3 steps.

1. Sign Up​

Create your account at app.debugg.ai.

In the web dashboard:

  1. Navigate to Settings → GitHub Integration
  2. Click Connect GitHub
  3. Authorize the DebuggAI GitHub App
  4. Select your repository

Projects auto-create when webhooks trigger. You don't need to manually create projects.

3. Configure Environment Secrets​

Once your project appears:

  1. Navigate to your project page
  2. Go to Environment tab
  3. Add required secrets:
    • DATABASE_URL - Your staging/development database connection
    • Any other secrets your app needs (API keys, service credentials, etc.)

Add the same secrets you use in your staging deployment.

What Happens Next​

  • Pull requests automatically trigger test runs
  • View results in the web dashboard
  • Get detailed test reports with screenshots and videos
  • Failed tests show AI-generated debugging insights

Manual Test Runs​

Trigger tests manually:

  1. Open your project dashboard
  2. Click Run Tests
  3. Select branch or PR to test
  4. View results in real-time

Troubleshooting​

Project not showing up?

  • Wait 1-2 minutes for webhooks to trigger
  • Check GitHub webhook delivery logs
  • Verify DebuggAI app has repository access

Tests not running?

  • Ensure environment secrets are configured
  • Verify your app starts successfully with provided secrets
  • Check test run logs for startup errors

Next Steps​