marketplace-deploy

WHEN YOUR AGENT SHOULD USE IT

A QUICK BOUNDARY

USE FOR

Ship a first production deploy of an app that has only ever run locally.
Set the Vercel environment variables an Auth0-based marketplace app needs before deploying.
Point a Sitecore app's Developer Portal settings at its new Vercel production URL.
Confirm a marketplace app's local build succeeds before pushing it to production.

Documents

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

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:

Build succeeds locally:

npm run build

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",
      },
    ],
  },
]

Environment variables are set — Check that .env.local exists and has required values
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:

Copy the production URL from Vercel
Go to Sitecore Developer Portal → Your App → Settings
Set the App URL to the Vercel production URL
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

Installation

Install this skill from vercel-labs/sitecore-skills on GitHub, not from a copy somewhere else. The command below does this for you.

Copy & paste — that's it

npx skills add vercel-labs/sitecore-skills --skill "marketplace-deploy" --full-depth

Run this in your project — your agent picks the skill up automatically.

BEFORE IT WILL WORK

2 FOR YOU · 1 FOR THE AGENT

01
Confirm the local build passes first
02
Set the app's environment variables in Vercel
03
Point the app's Sitecore settings at the new URL