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

# Ship on Vercel

> Deploy an App-bound Aomi widget to Vercel and verify that the public frontend reaches the configured App.

## Before you start

You need an activated Aomi App, a working local widget, Node.js 20 or newer, and a Vercel account.

## Build locally

```bash theme={null}
npm run build
```

Confirm that the production build can sign in and send a message from your local origin.

## Deploy

```bash theme={null}
npm install --global vercel
vercel
vercel --prod
```

Point the widget at the backend in **Settings → Environment Variables**:

```bash theme={null}
NEXT_PUBLIC_AOMI_API_URL=https://chat.aomi.dev
NEXT_PUBLIC_AOMI_APPLICATION_ID=123
```

Pass these values to `AomiWidget` through `apiUrl` and `applicationId`, replacing `123` with your activated App ID. Pass public provider identifiers through the selected `auth` object as shown in [Installation](/docs/guides/widget/installation). Serve the embed over HTTPS and allow the production Vercel origin in your wallet provider settings when that provider requires it.

<Warning>
  Never add App keys, provider secrets, paymaster credentials, or gas-policy credentials to frontend environment variables.
</Warning>