​
Overview

Bugster’s Vercel integration provides automated testing on every preview deployment, helping you catch bugs before they reach production. Here’s how it works:
  1. Deploy Trigger: When you push changes to a branch or create a pull request, Vercel automatically creates a preview deployment
  2. Bugster Activation: Once the Vercel deployment is complete, Bugster detects the new preview URL
  3. Automated Testing: Bugster runs your test suite and destructive agents against the preview deployment
  4. Results & Feedback: Test results are reported back, allowing you to identify and fix issues before merging
This integration ensures that every code change is thoroughly tested in a real deployment environment, preventing bugs from reaching your main branch and production.

​
Key Benefits

  • Early Bug Detection: Catch issues in preview deployments before they affect users
  • Automated Workflow: No manual intervention needed - tests run automatically on every deployment
  • Real Environment Testing: Tests run against actual deployed code, not just local development
  • Pull Request Integration: Get test results directly in your PR workflow
  • Destructive Testing: Advanced AI agents explore your app to find edge cases and potential issues

​
Protection Bypass for Automation

Bugster requires access to your Vercel preview deployments to run automated tests. To enable this, you need to create a “Protection Bypass for Automation” secret in Vercel and add it to your Bugster configuration.

​
Creating a Protection Bypass Secret

1

Navigate to Project Settings

  1. Go to your Vercel dashboard
  2. Select your project
  3. Navigate to Settings → Deployment Protection
2

Generate Protection Bypass for Automation Secret

  1. Scroll down to Protection Bypass for Automation
  2. Click Create Secret or Regenerate if one exists
  3. Copy the generated secret (it looks like: vercel_bypass_1a2b3c4d5e6f...)
Store this secret securely - it allows automated tools to access your preview deployments
3

Configure Bugster

Add the bypass secret to your Bugster configuration:During initialization:
bugster init --bypass-protection "vercel_bypass_1a2b3c4d5e6f..." --platform vercel
Or manually in .bugster/config.yaml:
project_name: "My App"
project_id: "my-app-123456" 
base_url: "http://localhost:3000"
x-vercel-protection-bypass: "vercel_bypass_1a2b3c4d5e6f..."
credentials:
  - id: "admin"
    username: "test@example.com"
    password: "testpass"

​
How the Bypass Works

When Bugster runs tests on your Vercel preview deployments:
  1. Header Injection: Bugster automatically includes the x-vercel-protection-bypass header with your secret
  2. Access Granted: Vercel recognizes the valid bypass secret and allows automated access to preview deployments
  3. Test Execution: Bugster can now run tests normally on the preview deployment
  4. Automation Enabled: This enables seamless CI/CD integration without manual intervention

​
Security Best Practices

​
Troubleshooting

​
Next Steps

GitHub Integration

Connect GitHub for complete CI/CD workflow with pull request comments

Test Configuration

Configure advanced testing options and environment-specific settings

Destructive Testing

Learn about AI-powered destructive agents for comprehensive bug detection

Results Analysis

Understand and analyze your test results and reports