Deploy Web App

Deploy the GTM Feedback web application to Vercel

One-Click Deploy

The fastest way to deploy GTM Feedback is using the one-click Vercel deploy button. This will automatically provision all required services:

Deploy to Vercel

Click to deploy with automatic service provisioning

This deployment will automatically set up:

• Neon Postgres - Database for accounts, opportunities, and feedback
• Upstash KV - Redis cache for session management
• Upstash Vector - Vector database for AI-powered semantic search

Manual Deployment

If you prefer to configure services manually or use different providers:

1. Fork the Repository

   Fork the gtm-feedback repository to your GitHub account.

2. Create a New Vercel Project

   1. Go to vercel.com/new
   2. Import your forked repository
   3. Set the root directory to apps/www
   4. Click “Deploy” (don’t worry about environment variables yet)
3. Set Up Required Services

   You’ll need to provision the following services:

   PostgreSQL Database

   Use any PostgreSQL provider (Neon, Supabase, RDS, etc.).

   For Neon:

   1. Create account at neon.tech
   2. Create a new project
   3. Copy the connection string
   4. Set as DATABASE_URL environment variable

   Upstash KV (Redis)

   Required for session management and caching.

   1. Create account at upstash.com
   2. Create a new Redis database
   3. Copy the REST API credentials
   4. Set KV_REST_API_URL, KV_REST_API_TOKEN, and KV_URL

   Google OAuth

   Required for user authentication.

   1. Go to Google Cloud Console
   2. Create a new project or select existing
   3. Enable Google+ API
   4. Create OAuth 2.0 credentials
   5. Add authorized redirect URI: https://your-app.vercel.app/api/auth/callback/google
   6. Copy Client ID and Client Secret
   7. Set as AUTH_GOOGLE_CLIENT_ID and AUTH_GOOGLE_SECRET

   OpenAI API

   Required for AI features and embeddings.

   1. Create account at platform.openai.com
   2. Generate an API key
   3. Set as OPENAI_API_KEY
4. Configure Environment Variables

   In your Vercel project settings, add all required environment variables. See the Environment Variables page for a complete list.

5. Deploy

   Trigger a new deployment from Vercel dashboard or push to your main branch.

Post-Deployment Setup

After your first deployment:

1. Run Database Migrations

   The database schema is automatically created on first connection. However, if you need to manually push the schema:

   pnpm db:push
   
2. Seed Demo Data (Optional)

   To populate your database with realistic demo data:

   pnpm db:seed
   

   This will create:

   • 5 internal users
   • 8 product areas for a B2B analytics SaaS
   • 10 customer accounts with varied ARR
   • ~30 opportunities
   • 15 feature requests
   • ~75 customer feedback entries
3. Verify Authentication

   1. Navigate to your deployed app
   2. Click “Sign in with Google”
   3. Verify you can successfully authenticate
4. Test Feedback Creation

   Create a test feedback item to ensure all integrations are working correctly.

Vercel Configuration

The project includes optimized Vercel configuration:

vercel.json

{
  "framework": "nextjs",
  "buildCommand": "pnpm build",
  "installCommand": "pnpm install",
  "regions": ["iad1"],
  "env": {
    "NEXT_TELEMETRY_DISABLED": "1"
  }
}

The app is configured to run in the iad1 (US East) region by default. You can change this to a region closer to your users for better performance.

Troubleshooting

Database connection errors

• Verify DATABASE_URL is correctly set
• Ensure your database allows connections from Vercel’s IP addresses
• Check that SSL mode is configured correctly (most providers require SSL)

Authentication fails

• Verify Google OAuth redirect URI matches your deployment URL exactly
• Check that AUTH_GOOGLE_CLIENT_ID and AUTH_GOOGLE_SECRET are set
• Ensure your Google OAuth app is not in testing mode or add test users

Build failures

• Check Vercel build logs for specific errors
• Ensure all required environment variables are set
• Verify your Node.js version matches requirements (18.x or higher)

Next Steps

Environment Variables

Complete reference for all configuration options

Slack Integration

Set up the Slack app for feedback collection