💡Quick Start

This page will run you through getting ZauberCMS up and running (Using either the .Net template or Nuget) and then creating your first page and getting data out the CMS.

Using .Net Template

Fastest way to get started is using the .Net Template, firstly install the ZauberCMS template (--force just makes sure you install the latest one)

dotnet new install ZauberCMS.Template --force

Then simple create your solution using the below:

dotnet new zaubercms -n "YourSiteName"

Watch this website build tutorial for more information

📹Website Build Video Tutorial

Using Nuget

If you want to use the Nuget package manually you can follow this video - Please note: This video is from when we were using Blazor for the front end, but the same concept applies now for V3+. Just create a new .NET MVC app instead of a Blazor app.

Video showing how to get started with the Nuget package

1. Create a new .NET MVC project

2. Clear out everything, so you are left with just the wwwroot and an empty program.cs like below

3. 

   Blank Blazor App
4. Now install the ZauberCMS nuget package

5. dotnet add package ZauberCMS

6. In your Program.cs, update it to add the AddZauberCMS methods to the builder and the app and the correct namespaces

7. using ZauberCMS.Components;
   using ZauberCMS.Core.Plugins;
   
   var builder = WebApplication.CreateBuilder(args);
   
   builder.AddZauberCms();
   
   var app = builder.Build();
   
   app.AddZauberCms<App>();
   
   app.Run();

8. Now build your solution, and the ZauberCMS appSettings.json default will be added to the solution,

9. Optional: By default it's setup to use SQLite. If you want to use MS SQL, then update the appSettings to point to your database and update the provider to the following

10. "DatabaseProvider": "SqlServer",
    "ConnectionString": "Server=YOURSERVER;Database=ZauberCMS;Trusted_Connection=True;Connect Timeout=200;TrustServerCertificate=True;",

11. Now just build and run the app and you'll see the install page with instructions to browse to /admin and create an account. The first account created will be made and admin, and it will redirect you to the admin.

Starter Site

Currently the repo for ZauberCMS on Github comes with the starter site out of the box and uses SQLite.

Get Up & Running

• Clone the repo

• Build and run the app

• When the starter site loads

• Go to /admin

• Register as a new user and you will be redirected to the admin