Vercel Deployment
Deploy the sync app to Vercel
This guide walks through deploying the sync application to Vercel.
One-Click Deploy
The easiest way to deploy is using the deploy button:
Environment Variables
During deployment, you'll need to configure these environment variables:
Required Variables
| Variable | Description | How to Get | Your Value |
|---|---|---|---|
| Session encryption key | Generate with openssl rand -base64 32 | ||
| Google OAuth client ID (auth + calendar) | Google OAuth Setup | ||
| Google OAuth client secret | Google OAuth Setup | ||
| Notion integration token | Notion Setup | ||
| Comma-separated emails, spaces trimmed | Your email or pattern (e.g., you@gmail.com, *@company.com) |
Redis storage (KV_REST_API_URL and KV_REST_API_TOKEN) is automatically provisioned via the deploy button. No manual setup needed.
Optional Variables
| Variable | Description | Default | Your Value |
|---|---|---|---|
| App URL (auto-detected on Vercel) | Auto | — | |
| Credential encryption key | None | ||
| Logging verbosity | info |
Generate Secrets
NEXTAUTH_SECRET is required. SETTINGS_ENCRYPTION_KEY is recommended for production.
Using OpenSSL (macOS/Linux)
openssl rand -base64 32Using Node.js
node -e "console.log(require('crypto').randomBytes(32).toString('base64'))"If using SETTINGS_ENCRYPTION_KEY, generate a separate value from NEXTAUTH_SECRET.
Post-Deployment Steps
1. Update Google OAuth Redirect URI
After deployment, update your Google OAuth credentials with your actual Vercel domain:
https://your-app-name.vercel.app/api/auth/callback/google2. Complete Setup Wizard
- Open your deployed app URL
- Follow the setup wizard to connect Google and Notion
- Configure field mappings
- Test the connection
3. Enable Cron Jobs (Optional)
Vercel automatically runs cron jobs defined in vercel.json:
- Notion sync: Daily at 3am UTC
- Webhook renewal: Daily at noon UTC
Note
Free Vercel accounts have cron job limitations. Check Vercel pricing for details.
Custom Domain (Optional)
To use a custom domain:
- Go to your Vercel project settings
- Click Domains
- Add your domain
- Update DNS records as instructed
- Update Google OAuth redirect URIs to use your custom domain
Troubleshooting
Updating the App
To update to the latest version:
- Go to your GitHub repository (created during deploy)
- Sync with the upstream repository
- Vercel will automatically redeploy
Or manually trigger a redeploy from the Vercel dashboard.