HomeGuidesAPI Reference
Submit Documentation FeedbackJoin Developer CommunityOptimizely GitHubOptimizely NuGetLog In

Environment setup for developers

This topic describes how to set up your developer workstation to start building Configured Commerce Cloud solutions.


To successfully set up your Configured Commerce in the Cloud developer environment, the following must be completed:

  • Possess knowledge and understanding of the Git technology and command line tools
  • Create a private GitHub repository and have access to edit collaborators
  • Optimizely has completed the provisioning of the Sandbox and Production Configured Commerce Cloud instances.

Cloud developer workstation works on currently supported Microsoft Windows installations only. Linux and macOS are not supported.

Developer workstation setup process

Authorize Optimizely account to GitHub



This is only allowed for organizations, not personal accounts. For personal accounts, Github only allows full access collaborators. To clone the Configured Commerce Cloud repo, you need to create a shared service account and the Configured Commerce Cloud hosting team will add you to the group needed to gain access to run the "git clone <<https://github.com/InsiteSoftware/insite-commerce-cloud.git>>" after you submit a ticket.

If you are new to Configured in the Cloud and you are not working on an active project, please submit a support ticket requesting an invitation to the Configured Commerce Git repository. When creating Git accounts, please create a shared group account, as individual accounts are not allowed. For example, partnername-Optimizely not JonDoe-partner.

Only complete this section if you are connecting your repo to an environment hosted by Optimizely. This step allows build server access to the repository so support can pull your extensions into your environment. Do not complete this step if you are completing the developer training course.

  1. On github.com navigate to the repo.
  2. Go to Settings > Collaborators & Teams.
  3. Under Collaborators enter "insite-teamcity-build" and click Add collaborator.
  4. Change permission for insite-teamcity-build to Read. 
Clone insite-commerce-cloud repository
  1. Open git bash or command line
  2. git clone https://github.com/InsiteSoftware/insite-commerce-cloud.git
Replace default remote origin
  1. Change directory to the cloned directory
  2. git remote rm origin
  3. git remote add origin [YourRemoteGitPath]
  4. For example, https://github.com/yourprofile/isccloud.git
Add upstream repository

Add the original upstream repository to receive any new updates deployed by Optimizely to the Configured Commerce.Web project in the repository. This will use git tags to identify releases. Git pull specific releases to test specific versions locally against customizations (theme and extensions).

  1. git remote add upstream https://github.com/InsiteSoftware/insite-commerce-cloud.git
  2. git push --set-upstream origin master
Create a custom Classic Theme or Spire Blueprint

Classic CMS - Create a project theme using the Powershell script provided. Multiple themes can be created in a single repository, however, themes cannot have the same name.

  1. In Windows Explorer, locate the local git repository and navigate to the /src folder
  2. Open Powershell and execute the ./createTheme.ps1 Powershell script
    For example, ./createTheme.ps1 -themeName "YourCustomTheme"
  3. Open the Configured Commerce.Web solution in Visual Studio and validate it contains an Extension library, Configured Commerce.Web project, and the custom Theme project.
**Check Environment Versions** - Use the steps under **Update Local Sandbox to Latest Version** in the [Configured Commerce Cloud Deployment Process]() article to make sure the version used to generate the theme is in sync with the deployed version. This is so you don't merge a code version that's ahead of what you've already deployed or are deploying with the new code you're merging.
Configure Optimizely NuGet source in Visual Studio

NuGet packages are available on <<https://nuget.optimizely.com/>>, which does not require authentication

Configure NuGet source

  1. In Visual Studio, navigate to Tools > Options > NuGet Package Manager > Package Sources
  2. Click Add
    1. Name - Configured Commerce
    2. Source - https://nuget.optimizely.com/
  3. Restore packages
Configure the local environment

Configure IIS, SQL, and the HOSTS file to debug the solution locally.



The following steps can be completed manually and without using the Configured Commerce installer.



The Configured Commerce installer is not supported.

  1. Locate the root directory of the local git repository and execute the Configured CommerceSetup.exe file
  2. Complete the setup using the guided instruction
  3. Open the HOSTS file with Administrator permissions and add the corresponding local entry
  4. Open Visual Studio and rebuild the solution
Finalize git branching

Create two local branches called sandbox and production. The remote branch is automatically created when you push it to the remote server. These will be used in their corresponding deployments. Production deployments will be scheduled by Optimizely. Theme and server-side customizations will not automatically go live upon push into the remote production branch. Sandbox deployments will be automated and any customizations will refresh the insitesandbox.com domain within a few minutes of a git push to the remote sandbox branch.

  1. Open git bash or command line and open the install location.
  2. git branch sandbox
  3. git branch production
  4. Verify the Configured Commerce website loads in the browser on the local dev machine.



Git is a distributed version control system. We only support pulling the Extensions code from GitHub, but the partner is free to use any version control system internally for their workflow. They can simply attach the Github repo to their internal repo as a remote and push code to it.