Set up the Merchant Portal

Edit on GitHub

This document provides details about how to set up the Spryker Merchant Portal.


To start using Merchant Portal, install Spryker Demo Shop:

  1. For the Marketplace project installation, use this repository.
  2. Install the project.


To build Merchant Portal, install or update the following tools:

  • Node.js—minimum version is v18.
  • npm—minimum version is v9.


The main environmental differences between the existing frontends (Yves, Zed) and Merchant Portal are the following:

  • Minimum Node.js version is v18.
  • Minimum npm version is v9.

Using a unified approach, all frontend dependencies must be installed in one step.

The entire project is now an npm workspace, meaning each submodule declares its dependencies. During the installation stage, npm installs all of those dependencies and stores them into the root of the project.

Install dependencies and build Merchant Portal

npm install
npm run mp:build

All available commands are listed in the package.json file in the root folder.

Once everything has been installed, you can access the UI of Merchant Portal by going to $[local_domain]/security-merchant-portal-gui/login.

All Merchant Portal modules are located in the /vendor/spryker/spryker directory.