Quickstart
Quickstart: record once, run on Vercel previews
This guide matches the launch wedge — one recorded flow executed against every preview deployment. Skip anything that does not shorten time-to-first-green-run.
1Prerequisites
- Next.js app deployed on Vercel with preview deployments enabled
- GitHub repository connected to that Vercel project
- Node 18+ locally for the CLI
2Install the CLI in your repo
- Run: npx testforge init (or npm i -g @testforge/cli && testforge init)
- Commit the generated config and workflow files the CLI adds
- Use testforge record against localhost or a staging URL to capture steps
3Connect TestForge to previews
- In the dashboard, open Test Settings and add the GitHub Actions workflow (or Vercel integration) so runs receive the preview URL
- Ensure TESTFORGE_BASE_URL (or your workflow’s Vercel URL output) points at the preview, not production
- Trigger a preview deploy; confirm a run appears in the dashboard
4Verify pass/fail
- Open the latest run: pass/fail, failed step, and screenshot should be visible
- If a selector breaks, check selector healing and update the flow once if needed