Deployments
Documentation and guides for OutcomeDev.
The Deployments tab in your Task Workspace shows the live Vercel preview deployment for your task's branch. It gives you a one-click link to see your changes running in a production-like environment — before you merge anything.
Prerequisites
The Deployments tab only works if your GitHub repository is connected to a Vercel project. If you don't use Vercel, this tab will show "No deployment found" — and that's completely normal.
To enable deployments:
- Connect your repo to Vercel — Go to vercel.com, import your GitHub repository, and set up a project. Vercel will automatically install a GitHub App on your repo.
- Push a branch — When OutcomeDev's agent creates a branch and pushes code, Vercel automatically creates a Preview Deployment for that branch.
- View it in the Deployments tab — Once the deployment succeeds, the preview URL appears in your Task Workspace.
No additional configuration is needed on the OutcomeDev side. If Vercel is connected, we detect it automatically.
How Detection Works
When a task completes, OutcomeDev checks for a Vercel preview deployment using the following chain (in order):
- Cached URL — If we already found a preview URL for this task, we return it instantly.
- GitHub Checks API — We look for check runs created by the
vercelGitHub App (e.g., "Vercel" or "Vercel Preview Comments") and extract the.vercel.appURL from their output. - GitHub Deployments API — We check for deployments with a
Previewenvironment that reference Vercel. - Commit Statuses API — We look for commit statuses with a
vercelcontext and a target URL.
If none of these return a URL, the tab shows "No deployment found."
What You See
- Preview URL — A direct link to the Vercel preview deployment (e.g.,
your-project-abc123.vercel.app). - Deployment Time — When the deployment was created.
- Open in New Tab — Click the link to view the full deployment in your browser.
Why Your Project Might Not Show a Deployment
| Scenario | Result |
|---|---|
| Repo is connected to Vercel | ✅ Deployments tab shows the preview URL |
| Repo is not connected to Vercel | ❌ "No deployment found" |
| Repo uses Netlify, Railway, etc. (not Vercel) | ❌ Not supported yet — only Vercel is detected |
| Task hasn't created a branch yet | ❌ No branch means no deployment to check |
| Vercel deployment is still building | ⏳ Check back in a moment — it refreshes automatically |
Difference from the Preview Pane
Don't confuse the Deployments tab with the Preview pane:
- Preview pane = Live iframe of the running sandbox dev server (temporary, disappears when sandbox stops)
- Deployments tab = Vercel's production-like preview deployment (persistent, stays available after the sandbox is gone)