Building from source

Note

The .NET 9 SDK is not yet supported. If you’re having issues with building, try uninstalling it and get the .NET 8 SDK instead.

Also, this can only be done on Windows as this uses the .NET Desktop Runtime.

First, download the source repository using either git clone or GitHub Desktop. Don’t download it as a .zip archive as you’ll just run into problems when you don’t use git.

git clone https://github.com/bloxstraplabs/bloxstrap.git
cd bloxstrap
git submodule init
git submodule update

From here, you can build using either Visual Studio, or the .NET CLI. If you don’t have Visual Studio installed, use the CLI.

Visual Studio

Note

These instructions are for building a release binary. Otherwise, you can just use the Visual Studio debugger.

Open Bloxstrap.sln in Visual Studio, right-click the Bloxstrap project in the Solution Explorer, and select ‘Publish’. Configure your build options if you need to (defaults are fine), and click ‘Publish’.

.NET CLI

If you don’t have Visual Studio installed, you can just download and install the .NET SDK for this one.

Open a Command Prompt window, and set your location to the folder containing Bloxstrap.sln. Then, run the following command:

dotnet publish Bloxstrap /p:PublishProfile=Publish-x64

If you need to configure any build options, run dotnet help publish to learn how to configure options for publishing.

---

Go to the Bloxstrap folder (the one containing Bloxstrap.csproj), where the artifacts will be located in bin\Release\net6.0-windows\publish. From there, you can either run and install it fresh, or copy it into your Bloxstrap install location.