Skip to content

Setup new solution

First time setup

In order to set up a new project from Bizzkit Blueprint you need to perform a number of manual steps in the right order.

Use the dotnet new template to create the initial code for the project (see how to install Bizzkit Blueprint).

Open af shell/cmd and step into the docker folder.

Run docker login crbizzkitpartner.azurecr.io --username "<username>" --password "<password>" to login to the Bizzkit container registry.

Create a developer certificate by following the Bizzkit's guide: Development certificates

Build the Blueprint containers locally.

.\docker-compose.cmd build
./docker-compose.sh build

Start the docker containers.

.\docker-compose.cmd up -d
./docker-compose.sh up -d

Wait for data seeding to finish. It will take a few minutes.

When it is done you can find the Bizzkit dashboard at https://localhost:8000 and log in using the username admin@admin.com and password Password123!.

Working with the new solution

After the initial setup and starting Bizzkit and the solution in Docker, you can work with the solution code and start developing.

Backend

If you open the .NET solution in your IDE and make changes to the code, you can start the backends using the normal "Run/Debug" feature in your IDE. There are launchSettings.json-files in each web project that specifies the localhost port the individual sites starts on. These match the ports in the Docker setup. So for instance the webshop can be found at https://localhost:9700.

Frontend

The main frontend is the website frontend that is based on React. You can find that inside the src/Blueprint.Presentation.Website/ClientApp folder.

The administration site also has some frontend scripts that needs to be bundled, but the frontend there is created using ASP.NET Core MVC.

For the frontends to work you need to build them separately. They are built using Webpack, but there are shortcuts available inside the website and administration projects to do so.

Example: Lets build the administration frontend

cd src\Blueprint.Presentation.Administration
.\frontend-build.cmd
cd src/Blueprint.Presentation.Administration
./frontend-build.sh

Repeat for the website folder.

Alternatively you can call npm directly to build them. If you are placed in the same folder as the package.json-file:

npm ci
npm run build:prod