I built a GitHub Action that solves a common pain point in CI/CD pipelines with Vercel deployments. Instead of relying on GitHub's deployment_status events, it actively polls Vercel's API to ensure deployments are truly ready before running tests or other checks.
Key technical features:
- Direct integration with Vercel's API for real-time deployment status
- Configurable polling with timeout and interval settings
- Support for team projects and branch aliases
- Works with both preview and production deployments
- No special webhook configuration needed
The main advantage is reliability: Many CI pipelines fail intermittently because they start running tests before Vercel deployments are actually ready. Traditional solutions rely on GitHub's deployment_status events, which can be unreliable or require complex setup.
This action solves that by:
1. Retrieving the latest deployment for your project/branch
2. Extracting the preview/production URL
3. Actively polling until the deployment is genuinely ready
Example use cases:
- Running E2E tests against preview deployments
- Multi-app testing workflows
- Post-production deployment validation
- Accessibility testing on live environments
I'd love feedback from the HN community, especially from those dealing with similar CI/CD challenges.
