Area: Optimizely Commerce
Applies to versions: 14 and higher

Creating a starter project

Recommended reading 

For better control and understanding, you should start developing in an empty project. However, you can install a sample site like Foundation to explore and use for inspiration. The Optimizely project templates provide a preconfigured website with Optimizely Commerce, and a Visual Studio project for development.

Creating the project

See Setting up a development environment to install the Optimizely templates and command line tool. When done, run the commands described in the following (check command line options for more configuration options).

dotnet new epicommerceempty --name ProjectName
cd projectname
dotnet-episerver create-cms-database ProjectName.csproj -S . -E
dotnet-episerver create-commerce-database ProjectName.csproj -S . -E --reuse-cms-user
dotnet-episerver add-admin-user ProjectName.csproj -u username -p password -e user@email.com -c EcfSqlConnection

The project structure

The project creation process completes these actions:

  • Installs main components through NuGet packages (EPiServer.Commerce).
  • Create the database.
  • Updates configuration files, such as appSettings.json, with connection strings.
  • Installs the Optimizely user interface components and places them under the URL /episerver.

When finalized, you have a project folder structure containing:

  • Properties. Launch settings for development server.
  • Infrastructure. Site components.
  • modules. Package modules.
  • wwwroot. Client resources.


The initialization module ensures that the catalog structure is added under the site's root level.


Updating to the latest

See Installing Optimizely updates to add the latest updates to a Commerce site.

Next step

Go to Adding e-commerce functionality to continue with the development of your e-commerce website.

Do you find this information helpful? Please log in to provide feedback.

Last updated: Sep 28, 2021

Recommended reading