marketplace-deploy

Deploy to Vercel

You are helping the user deploy their Sitecore Marketplace app to Vercel.

Important: This skill has real side effects (deploying to production). Confirm each step with the user before executing.

Pre-Deploy Checklist

Before deploying, verify:

1. Build succeeds locally:

npm run build

2. CSP headers are configured — Check next.config.ts for frame-ancestors:

// next.config.ts must include:
headers: [
  {
    source: "/(.*)",
    headers: [
      {
        key: "Content-Security-Policy",
        value: "frame-ancestors 'self' https://*.sitecorecloud.io",
      },
    ],
  },
]

3. Environment variables are set — Check that .env.local exists and has required values

4. Extension points are registered — All routes defined in the app should be registered in the Developer Portal

Deploy Steps

Step 1: Install Vercel CLI (if needed)

npm i -g vercel

Step 2: Link to Vercel project

vercel link

Step 3: Set environment variables

# For client-side apps
vercel env add NEXT_PUBLIC_SITECORE_APP_ID
 
# For full-stack (Auth0) apps — add all Auth0 vars too
vercel env add AUTH0_SECRET
vercel env add AUTH0_BASE_URL
vercel env add AUTH0_ISSUER_BASE_URL
vercel env add AUTH0_CLIENT_ID
vercel env add AUTH0_CLIENT_SECRET
vercel env add AUTH0_AUDIENCE
vercel env add AUTH0_SCOPE

Step 4: Deploy

# Preview deployment
vercel
 
# Production deployment
vercel --prod

Step 5: Post-Deploy Configuration

After deploying:

1. Copy the production URL from Vercel
2. Go to Sitecore Developer Portal → Your App → Settings
3. Set the App URL to the Vercel production URL
4. Update AUTH0_BASE_URL env var in Vercel to match the production URL (if using Auth0)

Reference Files

• Vercel Config — vercel.json and next.config.ts templates