Deployment - Stocks Signalist

Deploy to Vercel

Push code to GitHub

Ensure your latest changes are committed and pushed to the main branch.

Import in Vercel

Go to vercel.com, click Import Project, and select your repository.

Configure environment variables

In Vercel dashboard → Settings → Environment Variables, add:

NODE_ENV=production
BETTER_AUTH_URL=https://stocks-signalist.vercel.app
NEXT_PUBLIC_BASE_URL=https://stocks-signalist.vercel.app
MONGODB_URI=your_mongodb_connection_string
BETTER_AUTH_SECRET=your_secret
NODEMAILER_EMAIL=your_email@gmail.com
NODEMAILER_PASSWORD=your_app_password
NEXT_PUBLIC_FINNHUB_API_KEY=your_api_key

Do not override NODE_ENV — Vercel sets it to production automatically.

Deploy

Vercel auto-deploys on every push to main. Check build logs for errors.

Production Checklist

Critical Variables

BETTER_AUTH_URL — Must match your actual production domain. Wrong values cause broken email verification and password reset links.
MONGODB_URI — Must include /SignalisticsDB? in the connection string. See Environment Variables.
BETTER_AUTH_SECRET — Use a strong, unique secret different from development.

Email Configuration

NODEMAILER_EMAIL — Gmail account for sending emails
NODEMAILER_PASSWORD — Gmail app password (not your regular password)
Test email delivery after deploying

Post-Deploy Verification

Auth Flow
Database

Sign up with a new account
Verify the email is received with correct production URLs
Click the verification link
Sign in with the verified account
Test password reset flow

Verify the correct database is being used:

npx tsx scripts/list-collections.ts

Expected collections: user, account, session, verification, watchlists

Better Auth uses singular collection names: user, account, session, verification (not plural).

Monitoring

After deployment, keep an eye on:

Email delivery success rate
Authentication errors in Vercel logs
Database connection stability
API rate limits (Finnhub, Gemini)

Rollback Plan

If issues occur after deployment:

Keep previous environment variable values documented
Have a database backup ready
Revert BETTER_AUTH_URL if email links break
Use Vercel’s instant rollback to a previous deployment

​Deploy to Vercel

​Production Checklist

​Critical Variables

​Email Configuration

​Post-Deploy Verification

​Monitoring

​Rollback Plan

Deploy to Vercel

Production Checklist

Critical Variables

Email Configuration

Post-Deploy Verification

Monitoring

Rollback Plan