Vercel Integration
Automatically run Bug0 tests when Vercel deployments complete.
Features
Vercel integration provides:
- Automatic test triggers - Tests run when deployments succeed
- Preview URL testing - Test each preview deployment
- Production monitoring - Validate production deploys
- Zero configuration URLs - Bug0 gets the URL automatically
Setting Up Vercel
Step 1: Connect Vercel
- Open your project
- Go to Project Settings → Integrations → Vercel
- Click Connect to Vercel
- Authorize Bug0 to access your Vercel account
- Select which Vercel project to connect
Step 2: Configure Triggers
Choose when to run tests:
| Option | Description |
|---|---|
| Preview deployments | Run on PR/branch deploys |
| Production deployments | Run on production deploys |
| Both | Run on all deployments |
How It Works
1. You push code to GitHub
2. Vercel creates a deployment
3. Deployment succeeds
4. Bug0 receives webhook notification
5. Tests run against deployment URL
6. Results sent to configured channels
Deployment Types
Preview Deployments
Created for:
- Pull requests
- Branch pushes
- Manual triggers
URL format: https://project-git-branch.vercel.app
Production Deployments
Created when:
- Merging to main/master
- Manual production deploy
URL: Your configured production domain
Test Configuration
What Gets Tested
When triggered by Vercel:
- All published tests run
- Login suites execute first
- Cleanup suites execute last
URL Handling
Bug0 automatically uses the Vercel deployment URL, overriding your project's base URL for that run.
GitHub Integration
When both Vercel and GitHub are connected:
- Tests triggered by Vercel deployment
- Results posted to PR (via GitHub integration)
- Commit status updated
For the best experience, connect both Vercel and GitHub integrations. Vercel triggers the tests, GitHub receives the results.
Managing the Integration
View Connection Status
Go to Project Settings → Integrations → Vercel to see:
- Connected Vercel project
- Recent deployments
- Integration status
Change Vercel Project
- Open Vercel integration settings
- Select a different project
- Save
Disconnect Vercel
- Open Vercel integration settings
- Click Disconnect
- Confirm
Troubleshooting
Tests Not Triggering
- Verify Vercel integration is connected
- Check deployment type matches configuration
- Verify webhook is configured in Vercel
- Check deployment succeeded (failed deploys don't trigger)
Wrong URL Being Tested
- Verify Vercel project is correct
- Check deployment URL in test logs
- Ensure no URL override in API call
Vercel Project Not Listed
- Ensure Bug0 has access to the project
- Check Vercel account permissions
- Try reconnecting the integration
Best Practices
Test Preview Deployments
Run tests on every PR:
- Catch bugs before merge
- Validate changes in isolation
- Fast feedback loop
Monitor Production
Also run on production deploys:
- Verify deployment succeeded
- Catch environment-specific issues
- Confirm configuration is correct
Combine with GitHub
Connect both integrations:
- Vercel triggers tests
- GitHub shows results on PRs
- Complete CI/CD workflow