mcpField
M
marketplace-deploy

marketplace-deploy

github.com/vercel-labsCloud & DevOps553 installsUpdated 30w ago
Repository

About marketplace-deploy

marketplace-deploy is a skill for deploying Sitecore Marketplace apps to Vercel. It guides users through build and configuration checks, deployment, and post-deployment URL setup, requiring confirmation before actions with production side effects.

Key features

  1. 01Local build verification
  2. 02CSP and environment checks
  3. 03Extension point registration check
  4. 04Vercel project linking and deployment
  5. 05Post-deployment Sitecore configuration

Use cases

  1. 01Preparing a Sitecore Marketplace app for Vercel
  2. 02Checking required settings before deployment
  3. 03Deploying a preview or production build
  4. 04Updating the app URL in Sitecore Developer Portal

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/vercel-labs/sitecore-skills --skill marketplace-deploy

After installing, type/marketplace-deployin Claude Code to confirm it loaded.

Bundled filesreferences/vercel-config.md

Details

From the project README

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

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

  2. 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

Comments

Markdown supported