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

# Vercel Drain to Squasher SDK

> Move from deployment-level Vercel drains to SDK-powered error capture for richer context.

Vercel drains are the fastest way to get coverage, but the Squasher SDK gives you better stack frames, user context, breadcrumbs, release tags, and manual capture control.

## Setup

<Steps>
  <Step title="Keep the drain live">
    Leave your existing [Vercel drain](/integrations/vercel) in place while you install the SDK so
    you do not lose infrastructure and runtime coverage during rollout.
  </Step>

  <Step title="Install the SDK in the app">
    Add the SDK for your stack, then capture unhandled exceptions and any custom errors you want
    surfaced with richer metadata.
  </Step>

  <Step title="Tag releases and environments">
    Make sure the SDK sends release and environment values so issues line up with deploys and
    previews.
  </Step>
</Steps>

## Verify

* Trigger one handled exception through the SDK and one platform-level failure through the drain.
* Confirm the SDK event shows richer fields than the drain event.
* Confirm duplicate incidents are not created for the same application failure.

## Migrate

* Keep both paths during rollout.
* Move primary alerting to SDK-based issues once application coverage is complete.
* Keep the drain for infrastructure, edge, and platform logs that the SDK cannot see.

## Hot-swap

* Do not remove the drain unless you have another source for deployment and platform logs.
* Roll the SDK out route by route or service by service if the app is large.
* Verify one real deploy before changing paging rules.

## Agent handoff

```text theme={null}
Migrate from a Vercel drain to a Squasher SDK for project <project_id>. Keep the drain live, install the matching SDK, tag release and environment consistently, verify one SDK error and one drain event, and ask before changing alerting or removing the drain.
```
