marketplace-scaffold

Scaffold a New Sitecore Marketplace App

You are helping the user scaffold a new Sitecore Marketplace app using the official Sitecore Marketplace SDK (v0.4).

Step 1: Gather Requirements

Ask the user the following questions (skip any they've already answered):

1. App name — What should the app be called? (default: from $ARGUMENTS if provided)
2. Architecture — Client-side only or full-stack?
   • Client-side: UI runs entirely in the iframe, communicates via SDK client. Simpler, no server needed.
   • Full-stack: Includes Next.js API routes/server actions for server-side SDK access. Required for Auth0, server-side mutations, or proxying external APIs.
3. Authentication — Built-in (default) or Auth0?
   • Built-in: Zero-config, SDK handles auth automatically. Sufficient for most apps.
   • Auth0: Required for server-side API access, external service integration, or custom auth flows. Requires Auth0 tenant setup.
4. Optional packages — Which additional SDK packages?
   • XM Cloud (xmc): Access Sites, Pages, Authoring, Content Transfer, Search, and Agent APIs
   • AI Skills (ai): Access Brand Review API for AI-powered content analysis

Step 2: Run the Scaffold Command

Based on answers, construct and run the appropriate command:

# Client-side only (built-in auth)
npx shadcn@latest add https://marketplace-sdk.sitecorecloud.io/r/app-client.json
 
# Client-side + XMC
npx shadcn@latest add https://marketplace-sdk.sitecorecloud.io/r/app-client.json https://marketplace-sdk.sitecorecloud.io/r/xmc.json

Important: If the user doesn't have a Next.js project yet, scaffold one first:

Step 3: Post-Scaffold Setup

After scaffolding completes:

1. Create .env.local — See env-template.md for the template. Fill in based on architecture choice.

2. Configure CSP headers — Add iframe embedding headers to next.config.ts:

3. Install Blok theme (if not already present):

4. Verify setup — Run the dev server and confirm no errors:

Step 4: Explain Next Steps

After successful scaffold, suggest:

• Use /marketplace-add-extension to add extension point routes (custom fields, dashboard widgets, etc.)
• Use /marketplace-sdk-reference to look up SDK APIs
• Use /marketplace-build-component to build UI with the Blok design system
• Use /marketplace-deploy when ready to deploy

Reference Files

• Architecture Guide — Decision matrix for client-side vs full-stack
• Environment Template — .env.local templates per architecture