​

Vercel Deployment

​

Prerequisites

• Vercel account
• Project connected to GitHub
• Environment variables ready

​

Deployment Steps

​

1. Connect Repository

1. Go to Vercel Dashboard
2. Click “Add New Project”
3. Import your SHIELD repository
4. Select the frontend directory as root

​

2. Configure Project

​

3. Environment Variables

DATABASE_URL=postgresql://...
PINATA_JWT=eyJ...
PINATA_GATEWAY_URL=https://...
NEXT_PUBLIC_SHIELD_CONTRACT_BASE=0x...
NEXT_PUBLIC_SHIELD_CONTRACT_BASE_SEPOLIA=0x...
ALCHEMY_API_KEY=...
NEXT_PUBLIC_WC_PROJECT_ID=...
SESSION_SECRET=...
NEXT_PUBLIC_APP_URL=https://app.shieldhq.xyz

​

4. Deploy

1. Install dependencies
2. Run build
3. Deploy to edge

​

5. Custom Domain

1. Go to Project Settings → Domains
2. Add app.shieldhq.xyz
3. Configure DNS:
   • Type: CNAME
   • Name: app
   • Value: cname.vercel-dns.com

​

6. Preview Deployments

https://shield-git-branch-name-username.vercel.app

​

Production Checklist

• Environment variables set
• Database accessible from Vercel IPs
• Contract addresses correct
• Custom domain configured
• Analytics enabled
• Rate limiting configured
• Security headers set

​

Vercel.json Configuration

{
  "headers": [
    {
      "source": "/(.*)",
      "headers": [
        {
          "key": "X-Frame-Options",
          "value": "DENY"
        },
        {
          "key": "X-Content-Type-Options",
          "value": "nosniff"
        },
        {
          "key": "Referrer-Policy",
          "value": "strict-origin-when-cross-origin"
        }
      ]
    }
  ],
  "functions": {
    "app/api/**/*.ts": {
      "maxDuration": 30
    }
  }
}

​

Monitoring

• Analytics
• Speed Insights
• Logs
• Alerts

​

Troubleshooting