Vercel Integration

Connect to Vercel

Automatically sync your Drupal credentials to Vercel projects with one click. No manual environment variable configuration needed.

How It Works

1. Connect

Click "Connect to Vercel" in your dc-config page to authorize the integration via OAuth.

2. Select Project

Choose which Vercel project to connect from your account or team.

3. Sync

Environment variables are automatically pushed to your Vercel project. Just redeploy!

Environment Variables Synced

The following variables are automatically configured in your Vercel project:

Environment Variables

NEXT_PUBLIC_DRUPAL_BASE_URL=https://xxx.decoupled.website
DRUPAL_BASE_URL=https://xxx.decoupled.website
NEXT_IMAGE_DOMAIN=xxx.decoupled.website
DRUPAL_CLIENT_ID=your-oauth-client-id
DRUPAL_CLIENT_SECRET=your-oauth-client-secret
DRUPAL_REVALIDATE_SECRET=your-revalidate-secret

Note: Variables are set for all environments (Production, Preview, Development) by default.

Setup Guide

Navigate to dc-config

Go to your Drupal site's configuration page at /dc-config

Click "Connect to Vercel"

In the Vercel Integration section, click the connect button to start the OAuth flow.

Authorize Access

You'll be redirected to Vercel to authorize decoupled.io to access your projects. Accept the permissions to continue.

Select Your Project

Choose which Vercel project should receive the environment variables. You can select from your personal projects or any team projects you have access to.

Sync Environment Variables

Click "Sync to Vercel" to push all Drupal credentials to your selected project. You'll see a confirmation when complete.

Redeploy on Vercel

Go to your Vercel dashboard and trigger a new deployment to apply the environment variables.

Open Vercel Dashboard

Re-syncing Variables

If your OAuth credentials change (e.g., you regenerate a secret), you can re-sync at any time:

Return to /dc-config on your Drupal site
The connected project is shown in the Vercel section
Click "Sync to Vercel" to push updated credentials
Redeploy your Vercel project to apply changes

Security

How We Keep Your Credentials Safe

OAuth 2.0 Authorization

We use Vercel's official OAuth integration - we never see your Vercel password.

Minimal Permissions

We only request access to read projects and write environment variables.

Token Storage

Vercel tokens are stored encrypted and associated with your Drupal session.

Revocable Access

You can revoke access anytime from your Vercel account settings.

Troubleshooting

I don't see my project in the list

Make sure you authorized access to the correct Vercel account or team. You can disconnect and reconnect to re-authorize with a different scope.

Sync failed with an error

Check that your Vercel token hasn't expired. If the error persists, try disconnecting and reconnecting your Vercel account.

Environment variables not appearing in Vercel

After syncing, you need to trigger a new deployment for the variables to take effect. Go to your Vercel project and click "Redeploy".

How do I disconnect from Vercel?

On the dc-config page, look for the "Disconnect" option in the connected project card. You can also revoke access from your Vercel account settings under "Integrations".