salesforcecommercecloud Deployment Skill
This skill covers building and deploying Storefront Next storefronts to Managed Runtime (MRT).
Overview
Storefront Next storefronts are deployed to MRT as bundles. The sfnext CLI handles building and pushing bundles, while environment configuration is managed through MRT environment variables.
Production Build
# Build for production
pnpm build
# The build output goes to build/ directory
The production build:
- Compiles TypeScript to JavaScript
- Bundles client and server code separately
- Optimizes and minifies assets
- Generates the static Page Designer registry
Deploying to MRT
Using sfnext CLI
# Push the current build to MRT
pnpm push
# Push with a specific message
pnpm sfnext push -m "Release v1.2.0"
# Push to a specific environment
pnpm sfnext push --environment staging --wait
Deployment Flow
pnpm build → pnpm push → MRT receives bundle → Deployed to environment
See MRT Deployment Reference for detailed deployment options.
Environment Configuration
Environment variables for MRT are configured through:
- MRT Dashboard — Set
PUBLIC__variables per environment (baked into the app at build time) - CLI flags or
MRT_*environment variables — Control push/deploy targets .envfiles — Local development only (not deployed)
MRT Deployment Variables
# Project slug (required for push)
MRT_PROJECT=my-project-slug
# Target environment (optional — if omitted, bundle is uploaded but not deployed)
MRT_TARGET=development
Application Variables (set in MRT Dashboard)
PUBLIC__app__commerce__api__clientId=prod-client-id
PUBLIC__app__commerce__api__organizationId=prod-org-id
PUBLIC__app__commerce__api__shortCode=prod-short-code
Page Designer Cartridge Deployment
Page Designer metadata must be deployed separately to Commerce Cloud (not MRT):
# Generate cartridge metadata
pnpm generate:cartridge
# Deploy cartridge to B2C instance
pnpm deploy:cartridge
# Deploy with clean (removes old cartridge first)
pnpm deploy:cartridge:clean
# Validate cartridge structure
pnpm validate:cartridge
Cartridge metadata is also auto-generated as part of pnpm build.
Pre-Deployment Checklist
- Run tests —
pnpm test - Check bundle size —
pnpm bundlesize:test - Verify environment variables — All required vars set in target environment
- Build successfully —
pnpm buildcompletes without errors - Verify SCAPI credentials — Client ID and org ID match the target environment
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| Build fails | TypeScript errors | Fix type errors; run pnpm typecheck |
| Push rejected | Authentication issue | Verify sfnext CLI credentials |
| 500 errors after deploy | Missing environment variables | Check all required vars in MRT dashboard |
| Stale Page Designer components | Cartridge not deployed | Re-deploy cartridge via MCP tool or b2c CLI |
Related Skills
storefront-next:sfnext-project-setup- Project structure and build configurationstorefront-next:sfnext-configuration- Environment variable configurationstorefront-next:sfnext-page-designer- Page Designer cartridge deploymentstorefront-next:sfnext-performance- Bundle size optimization before deploymentb2c-cli:b2c-mrt- General MRT management via b2c CLI (NOT Storefront Next specific)
Reference Documentation
- MRT Deployment Reference - Detailed deployment options and configuration