Statiq boilerplate for Kontent.ai

Statiq boilerplate for Kontent.ai is a GitHub boilerplate template that combines the Statiq static site generator with the Kontent.ai headless CMS, giving .NET developers a ready-made Jamstack starting point.

What is Statiq boilerplate for Kontent.ai?

This template provides a foundation for building static websites with .NET. It takes content stored in a Kontent.ai project and generates a fully static HTML site using Statiq, a static site generator for .NET. The output is a static site that can be hosted anywhere, and the content is loaded from Kontent.ai via the Kontent.Statiq module. The project is maintained by the Kontent.ai organization and includes a live demo hosted on GitHub Pages.

Key Features

• Kontent.ai Model Generator – Automatically generates strongly-typed C# models from your Kontent.ai content types, so you can work with typed objects instead of raw JSON.
• Kontent.Statiq module – Simplifies loading content from Kontent.ai into those strongly-typed models during the site generation pipeline.
• Sass styling with reset.css – Includes initial Sass styles and Eric Meyer's reset.css to give you a clean starting point for custom styling.
• Razor template engine – Uses the Razor templating syntax with a simple layout, familiar to ASP.NET developers.
• Pre-configured shared Kontent.ai project – The default configuration loads content from a shared Kontent.ai project, so you can run the site immediately.
• Easy personalization – You can create your own Kontent.ai project using the Sample site generator, then update the project ID in the configuration to use your own content.
• .NET 6 – Requires .NET 6 SDK to run locally.
• Live demo – A working example is available at https://kontent-ai.github.io/boilerplate-statiq-net.

Who is it for?

• .NET developers who want to try Jamstack without learning JavaScript-based static site generators.
• Teams already using Kontent.ai who need a static site front-end with strongly-typed models.
• Developers who prefer Razor templates and want to build content-driven sites with C#.

What can you do with it?

• Build a blog or content site – Use Kontent.ai as the headless CMS and generate a static site with Razor templates.
• Customize the design – Modify the Sass files and layout to match your brand.
• Automate model generation – Run the included model generator scripts to regenerate C# models whenever your content types change.

How does it work?

To get started, click the "Use this template" button on GitHub to create your own repository. Clone it, ensure .NET 6 is installed, and run dotnet run -- preview. The site will be available at http://localhost:5080. To use your own Kontent.ai project, create a sample project in Kontent.ai, copy the Project ID, and update the appsettings.json file and the model generator scripts accordingly.