Spryker B2B Marketplace Demo Shop

Description

Spryker B2B Marketplace Demo Shop is a collection of Spryker Marketplace B2B-specific features. It suits most projects as a starting point of development and can be used to explore Spryker.

B2B Marketplace Demo Shop quick start

This section describes how to get started with the B2B Marketplace Demo Shop quickly.

For detailed installation instructions, see Install Spryker.

Prerequisites

Recommended system requirements for MacOS:

Macbook type	vCPU	RAM
15'	4	6GB
13'	2	4GB

Install the B2B Marketplace Demo Shop

Create a project folder and navigate into it:

mkdir spryker-b2b-marketplace && cd spryker-b2b-marketplace

Clone the B2B Marketplace Demo Shop:

git clone https://github.com/spryker-shop/b2b-demo-marketplace.git ./spryker-b2b-marketplace

Clone the Docker SDK:

git clone git@github.com:spryker/docker-sdk.git docker

Set up a desired environment:

Set up a development environment
Set up a production-like environment

Set up a development environment

Bootstrap the docker setup:

docker/sdk boot deploy.dev.yml

If the command you've run in the previous step returned instructions, follow them.
Build and start the instance:

docker/sdk up

Switch to your branch, re-build the application with assets and demo data from the new branch:

git checkout {your_branch}
docker/sdk boot -s deploy.dev.yml
docker/sdk up --build --assets --data

Depending on your requirements, you can select any combination of the following up command attributes. To fetch all the changes from the branch you switch to, we recommend running the command with all of them:

--build - update composer, generate transfer objects, etc.

--assets - build assets

--data - get new demo data

You've set up your Spryker B2B Marketplace Demo Shop and can access your applications.

Set up a production-like environment

Bootstrap the docker setup:

docker/sdk boot -s

If the command you've run in the previous step returned instructions, follow them.
Build and start the instance:

docker/sdk up

Switch to your branch in one of the following ways:

Switch to your brunch, re-build the application with assets and demo data from the new branch:

git checkout {your_branch}
docker/sdk boot -s
docker/sdk up --assets --data

Light git checkout:

git checkout {your_branch}
docker/sdk boot -s

docker/sdk up

Depending on your requirements, you can select any combination of the following up command attributes. To fetch all the changes from the branch you switch to, we recommend running the command with all of them:

--build - update composer, generate transfer objects, etc.

--assets - build assets

--data - get new demo data

Reload all the data:

docker/sdk clean-data && docker/sdk up && docker/sdk console q:w:s -v -s

You've set up your Spryker B2B Marketplace Demo Shop and can access your applications.

Troubleshooting installation of the B2B Marketplace Demo Shop

This section describes the most common issues related to the installation of the B2B Marketplace Demo Shop.

For a complete troubleshooting, see Troubleshooting Spryker installation issues.

when

You get unexpected application behavior or errors.

then

Check the state of the directory:

git status

If there are untracked files (returned in red), and they are not necessary, remove them.
Restart file synchronization and rebuild the codebase:

docker/sdk trouble
docker/sdk boot -s deploy.dev.yml
docker/sdk up --build --assets

when You do not see the expected demo data on the Storefront.

then

Open the queue broker and wait until all the queues are empty.
If the queues are empty, and the issue persists, reload the demo data:

docker/sdk trouble
docker/sdk boot -s deploy.dev.yml
docker/sdk up --build --assets --data

Contributing to the repository

For contribution guidelines, see Code contribution guide.