> ## Documentation Index
> Fetch the complete documentation index at: https://vlyai-1c28d863.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Preview deployments

> Per-change preview URLs for collaborative review. Multi-preview workflows for parallel work.

Every change in vly produces a preview deployment automatically. Per-branch previews let multiple developers work in parallel.

## Default behavior

* Every commit on `main` updates the main preview URL.
* Every push to a branch creates a per-branch preview URL: `your-branch.your-project.vly.app`.
* Previews are public but unindexed (`X-Robots-Tag: noindex`).

## Sharing a preview

Preview URLs are shareable as-is. For password protection, see [Sharing projects](/building/sharing-projects).

## Multi-preview workflow

For teams reviewing many parallel features:

<Steps>
  <Step title="Each developer works on a branch">
    [Branch](/building/branching) per feature.
  </Step>

  <Step title="Each branch has its own preview URL">
    Auto-generated; no manual deploy step.
  </Step>

  <Step title="Reviewers comment on the preview directly">
    Inline comments on the deployed UI; threaded discussion in vly.
  </Step>

  <Step title="When approved, merge into main">
    Main's preview updates; eventually promoted to production.
  </Step>
</Steps>

## Limits

* Per plan, you can have a fixed number of concurrent branch previews:
  * Free: 1
  * Pro: 10
  * Business: 50
  * Enterprise: Unlimited
* Old branch previews are archived after 30 days of no activity (can be restored).

## Tips

<Tip>
  **Name branches descriptively.** `feature/billing-portal` reads better than `wip-2`. The branch name is in the preview URL.
</Tip>

<Tip>
  **Don't promote previews directly to production for unverified changes.** Use staging if you have multiple reviewers.
</Tip>

## Related

<CardGroup cols={3}>
  <Card title="Branching" icon="git-branch" href="/building/branching">
    The branching model.
  </Card>

  <Card title="Comments and reviews" icon="message-square" href="/building/comments-and-reviews">
    Inline review.
  </Card>

  <Card title="Sharing projects" icon="share-2" href="/building/sharing-projects">
    Public / password-protected previews.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.