Migrate from Konstrukt to Umbraco UI Builder
Learn how to migrate a Konstrukt solution to Umbraco UI Builder.
This guide provides a step-by-step approach to migrating a default Konstrukt solution to Umbraco UI Builder.
Key changes
Before outlining the exact steps, there are a few key changes to be aware of.
These changes will dictate the steps to take in the process of migrating to Umbraco UI Builder.
Project, Package, and Namespace changes
Konstrukt.Core
Umbraco.UIBuilder.Core
Konstrukt.Infrastructure
Umbraco.UIBuilder.Infrastructure
Konstrukt.Web
Umbraco.UIBuilder.Web
Konstrukt.Web.UI
Umbraco.UIBuilder.Web.StaticAssets
Konstrukt.Startup
Umbraco.UIBuilder.Startup
Konstrukt
Umbraco.UIBuilder
Step 1: Replace dependencies
In this first step, we will be replacing all existing Konstrukt dependencies with Umbraco UI Builder dependencies.
Remove any installed Konstrukt packages:
Delete the Konstrukt
App_Plugins
folder:
Install
Umbraco.UIBuilder
:
Compile your project against .NET 7.0.
Step 2: Update namespaces and entity names
Step 3: Update your configuration
Step 4: Finalizing the migration
Delete any obj/bin folders in your projects to ensure a clean build.
Recompile all projects and ensure all dependencies are restored correctly
Delete the existing Konstrukt license files in the
umbraco\Licenses
folder.Add your new Umbraco.UIBuilder license key to the
appSettings.json
file:
Run the project.
Last updated