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.

Containers are bound to a range of ports on localhost and because of that, only a localhost certificate is required to be installed for the current setup to work.

To generate the certificate:

  • Navigate to the docker folder included with the template.
  • If you find a folder named /certificates, delete it before continuing.
1
docker run -it --rm -v .\certificates:/certs crbizzkitpartner.azurecr.io/bizzkit/cert-generator:23.24.10

1
docker run -it --rm -v ./certificates:/certs crbizzkitpartner.azurecr.io/bizzkit/cert-generator:23.24.10

After running the cert-generator the certificate must be trusted.

  1. Double click localhost-certificates-install.pfx
  2. Use Local Machine for store location
  3. Use default-password for password
  4. Select Place all certificates in the following store
  5. Click Browse and select Trusted Root Certification Authorities
  6. Finish
  1. Open the Keychain Access app
  2. Click File > Import Items
  3. In the new window find localhost.pfx and open it
  4. Use default-password for password
  5. Click ok to complete the process

Search in your distribution for the correct way to import the certificate

Build the Blueprint containers locally.

1
.\docker-compose.cmd build

1
./docker-compose.sh build

Start the docker containers.

1
.\docker-compose.cmd up -d

1
./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

1
2
cd src\Blueprint.Presentation.Administration
.\frontend-build.cmd

1
2
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:

1
2
npm ci
npm run build:prod