Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket

Build and deploy themes in cloud

Describes how to build and deploy themes.

Optimal configuration

Starting with Configured Commerce 4.5, Optimizely focused the options for theme building and deployment on a central strategy that minimizes downtime and improves stability. The approach uses a build server to compile the theme's TS/SCSS files, then deploys only the resulting JS/CSS files to the web server. By building the themes ahead of time, sites start faster, have fewer moving parts, and rely less on the database.

❗️

Warning

Deprecation Notice: The Git Theme Source feature is now deprecated and will be removed in a future release. Cloud environments will automatically be converted to the preferred configuration. The improvements with 4.5.0 make file system themes the most reliable option going forward.

Build themes

For Configured Commerce Cloud, the build process is baked into the CI process. The correct project structure is created automatically for themes that were initialized with createTheme.ps1.

If the build server does not find a package.json file for the theme, the build process will use the default package.json file with the associated TypeScript compiler and Grunt task runner.

Upgrade to 4.5.0 from older versions

Configured Commerce Cloud customers will automatically get the theme improvements in 4.5.0. Cloud customers only need to ensure that the theme compiles without errors so that the deployments execute cleanly.

📘

Note

The environments effected by these changes are self-managed environments such as SDK environments or private Configured Commerce Cloud test environments.