> ## Documentation Index
> Fetch the complete documentation index at: https://docs.capy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Vercel Preview Deployments

> Capy detects Vercel preview deployments from PR comments and surfaces live previews in the dashboard alongside code diffs — no webhooks or API keys needed.

## Overview

Capy detects Vercel preview deployments automatically from PR comments and surfaces them in the dashboard. Review code diffs and live previews side by side, no webhooks or API keys needed.

## How it works

When Vercel deploys a preview from a PR branch, it posts a comment with the preview URL. Capy scans PR comments for URLs with `preview` in the hostname and surfaces the first match in the PR toolbar.

<Steps>
  <Step title="Connect your repo">
    Link your Vercel project to GitHub. When Vercel deploys previews on PRs,
    Capy detects them automatically.
  </Step>

  <Step title="Agent opens a PR">
    An agent works on your task and opens a PR. Vercel triggers a preview
    deployment from the branch.
  </Step>

  <Step title="Preview in Capy">
    Capy detects the preview URL from the PR discussion. Click **Open preview
    link** in the PR view to see the live deployment.
  </Step>
</Steps>

No configuration is required. If Vercel is connected to your GitHub repo, it just works.

## In-VM previews

For previewing during a task *before* a PR exists, start your service in the VM.
Capy discovers listening HTTP services automatically and exposes them from the
Desktop services menu.

## Full workflow

1. Start an in-VM service so the agent validates changes while coding
2. Agent opens a PR when done
3. Vercel deploys a preview from the branch
4. You review code and the live deployment from Capy's PR view

## Limitations

* Only the first matching preview URL per PR is surfaced
* Capy does not trigger Vercel deployments — your existing Vercel setup handles the deploy pipeline
* Preview detection relies on Vercel's PR comments; if comments are disabled, previews won't appear

## FAQ

<AccordionGroup>
  <Accordion title="Do I need to configure anything?">
    No. If Vercel is connected to your GitHub repo, Capy detects preview URLs
    from PR comments automatically. There's nothing to install or configure.
  </Accordion>

  <Accordion title="Does Capy trigger Vercel deployments?">
    No. Capy reads preview URLs from PR comments but doesn't trigger
    deployments. Your existing Vercel setup handles the deploy pipeline.
  </Accordion>

  <Accordion title="Can I see multiple preview URLs?">
    Currently, Capy surfaces the first matching preview URL from PR comments.
    The Desktop services menu discovers multiple in-VM HTTP services
    automatically.
  </Accordion>
</AccordionGroup>