Netlify Integration
Automatically run Bug0 tests when Netlify deployments complete.
Features
Netlify integration provides:
- Automatic test triggers - Tests run when deploys succeed
- Deploy preview testing - Test branch deploys
- Production monitoring - Validate production deploys
- Automatic URL detection - Bug0 gets the deploy URL
Setting Up Netlify
Step 1: Connect Netlify
- Open your project
- Go to Project Settings → Integrations → Netlify
- Click Connect to Netlify
- Authorize Bug0 to access your Netlify account
- Select which Netlify site to connect
Step 2: Configure Triggers
Choose when to run tests:
| Option | Description |
|---|---|
| Deploy previews | Run on branch/PR deploys |
| Production deploys | Run on production publishes |
| Both | Run on all successful deploys |
How It Works
1. You push code or trigger deploy
2. Netlify builds and deploys
3. Deploy succeeds
4. Bug0 receives notification
5. Tests run against deploy URL
6. Results sent to configured channels
Deploy Types
Deploy Previews
Created for:
- Pull requests
- Branch builds
- Deploy previews
URL format: https://deploy-preview-123--yoursite.netlify.app
Production Deploys
Created when:
- Publishing to production
- Main branch builds
- Manual production deploy
URL: Your configured domain
Test Configuration
What Gets Tested
When triggered by Netlify:
- All published tests run
- Login suites execute first
- Cleanup suites execute last
URL Handling
Bug0 automatically uses the Netlify deploy URL, overriding your project's base URL for that run.
GitHub Integration
When both Netlify and GitHub are connected:
- Tests triggered by Netlify deploy
- Results posted to PR (via GitHub integration)
- Commit status updated
Connect both Netlify and GitHub for the complete workflow: Netlify triggers tests, GitHub shows results on PRs.
Managing the Integration
View Connection Status
Go to Project Settings → Integrations → Netlify to see:
- Connected Netlify site
- Recent deploys
- Integration status
Change Netlify Site
- Open Netlify integration settings
- Select a different site
- Save
Disconnect Netlify
- Open Netlify integration settings
- Click Disconnect
- Confirm
Troubleshooting
Tests Not Triggering
- Verify Netlify integration is connected
- Check deploy type matches configuration
- Verify deploy succeeded (failed builds don't trigger)
- Check outgoing webhooks in Netlify settings
Wrong URL Being Tested
- Verify Netlify site is correct
- Check deploy URL in test logs
- Ensure no URL override in API call
Netlify Site Not Listed
- Ensure Bug0 has access to the site
- Check Netlify account permissions
- Try reconnecting the integration
Best Practices
Test Deploy Previews
Run tests on every PR deploy:
- Validate changes before merge
- Test in production-like environment
- Catch integration issues early
Monitor Production
Also run on production deploys:
- Verify deploy succeeded
- Catch production-only issues
- Confirm everything works
Combine with GitHub
Connect both integrations:
- Netlify triggers tests
- GitHub shows results on PRs
- Full CI/CD integration