TemplateBuilder.Editor
1.3.4
dotnet add package TemplateBuilder.Editor --version 1.3.4
NuGet\Install-Package TemplateBuilder.Editor -Version 1.3.4
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="TemplateBuilder.Editor" Version="1.3.4" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="TemplateBuilder.Editor" Version="1.3.4" />
<PackageReference Include="TemplateBuilder.Editor" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add TemplateBuilder.Editor --version 1.3.4
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: TemplateBuilder.Editor, 1.3.4"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package TemplateBuilder.Editor@1.3.4
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=TemplateBuilder.Editor&version=1.3.4
#tool nuget:?package=TemplateBuilder.Editor&version=1.3.4
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
TemplateBuilder.Editor
Current version: 1.3.4
Embed a full Scriban-powered HTML template management UI into any ASP.NET Core web application. Install the package, call two methods, and your users can create, edit, version, preview, and restore templates — all wrapped in your own site layout.
Requirements
- .NET 10
- ASP.NET Core MVC
- SQL Server
Quick Start
1. Install
dotnet add package TemplateBuilder.Editor --version 1.3.4
2. Add a connection string
// appsettings.json
{
"ConnectionStrings": {
"TemplateDb": "Server=.;Database=TemplateBuilder;Trusted_Connection=True;TrustServerCertificate=True;"
}
}
3. Register in Program.cs
using TemplateBuilder.Editor;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews(o =>
{
// Required: prevents empty template body from silently failing on Create
o.SuppressImplicitRequiredAttributeForNonNullableReferenceTypes = true;
});
builder.Services.AddTemplateBuilderEditor(options =>
{
options.ConnectionString = builder.Configuration.GetConnectionString("TemplateDb")!;
});
var app = builder.Build();
if (!app.Environment.IsDevelopment())
{
app.UseExceptionHandler("/Home/Error");
app.UseHsts();
}
app.UseHttpsRedirection();
app.UseStaticFiles(); // required — serves /_content/TemplateBuilder.Editor/ assets
app.UseRouting();
app.UseAuthorization();
app.MapControllers(); // required — registers attribute-routed endpoints (Edit, Preview, etc.)
app.MapControllerRoute(
name: "default",
pattern: "{controller=Home}/{action=Index}/{id?}");
app.Run();
Two things that are easy to miss:
app.MapControllers()must appear beforeMapControllerRoute. Without it, Edit, Preview, SaveVersion, and Versions routes return 404.SuppressImplicitRequiredAttributeForNonNullableReferenceTypes = trueis needed to allow creating templates with an empty body.
4. Wire up the layout
Add @await RenderSectionAsync("Styles", required: false) inside <head> and @await RenderSectionAsync("Scripts", required: false) before </body> in your Views/Shared/_Layout.cshtml:
<head>
...
@await RenderSectionAsync("Styles", required: false)
</head>
<body>
...
@RenderBody()
...
@await RenderSectionAsync("Scripts", required: false)
</body>
Add a nav link to the editor:
<a asp-controller="Templates" asp-action="Index">Templates</a>
5. Run
dotnet run
EF Core migrations run automatically on first startup — the database and schema are created for you. Navigate to /Templates.
Setup Diagnostic Page
After installation, navigate to /Templates/_setup in Development to verify every integration requirement at once:
| Check | What it detects |
|---|---|
| Database connection | SQL Server reachable with the configured connection string |
| Migrations applied | All EF Core schema migrations are current |
app.MapControllers() registered |
Attribute-routed endpoints are accessible |
SuppressImplicitRequired |
Empty template body won't silently fail |
| Static assets | /_content/TemplateBuilder.Editor/ is being served |
@section Styles |
RenderSectionAsync("Styles") is in your layout <head> |
@section Scripts |
RenderSectionAsync("Scripts") is in your layout before </body> |
| CSS/JS files loaded | template-editor.css and template-editor.js are linked |
Every failing check shows a one-line fix. The page returns 404 in non-Development environments.
What's New
v1.3.4
- Fix: Snippets panel now loads correctly —
ISnippetRepositorywas missing fromAddTemplateBuilderEditor()DI registrations, causing a 500 onGET /Templates/Api/Snippets.
v1.3.3
- Fix: Editor canvas no longer blank on load — the custom anchor plugin was renamed from
anchortoinsertAnchorto avoid colliding with SunEditor's internalcore.context.anchorcontext used by the built-in link plugin.
v1.3.2
- Line Height — line height dropdown (1.0–3.0) in the font toolbar group.
- Special Characters — floating Ω picker with 5 groups (~80 chars) and live search.
- Print — 🖨 toolbar button triggers browser print dialog.
- Custom List Styles — "≡▾" dropdown applies disc/circle/square/decimal/upper-alpha/lower-roman to the active list.
- Anchor Links — ⚓ toolbar button inserts a named anchor chip; link to it via
#namein the standard link dialog.
v1.3.1
- Fix: SunEditor content no longer lost when Create form fails validation — body is now synced to the form before submission.
- Fix: Validation errors (e.g. missing template name) are now shown inline on the Create form instead of silently resetting the page.
- Fix: Body content entered on the Create screen is now saved as v1 when the template is created, so the Edit screen opens with content intact.
v1.3.0
- Reusable Content Snippets — Save any selection as a named snippet and insert it into any template from the Snippets panel. Full CRUD API (
GET/POST/DELETE /Templates/Api/Snippets).
v1.2.1
- Merge & Split Table Cells — Multi-cell selection with colspan/rowspan support via the floating table toolbar.
v1.2.0
- Font Family Selection — Choose from common web-safe and system font families in the toolbar.
- Fullscreen Editing — Toggle distraction-free fullscreen mode.
- Word & Character Count — Live count displayed in the editor status bar.
- Auto-save Drafts — Unsaved changes are preserved across page reloads.
- Find & Replace — Floating panel (Ctrl+H) with highlight, navigation, and bulk replace.
- Clean Paste from Word/Outlook — Strips proprietary formatting on paste, preserving semantic structure.
Features
| Feature | Route |
|---|---|
| Template list | GET /Templates |
| Create template | GET/POST /Templates/Create |
| Edit template | GET /Templates/{id}/Edit |
| Save version | POST /Templates/{id}/SaveVersion |
| Version history | GET /Templates/{id}/Versions |
| Restore version | POST /Templates/{id}/Restore/{versionId}/{sourceVersionNumber} |
| Live preview | POST /Templates/{id}/Preview |
| Duplicate | POST /Templates/{id}/Duplicate |
| Validate syntax | POST /Templates/{id}/Validate |
| Toggle active | POST /Templates/{id}/ToggleActive |
| List snippets | GET /Templates/Api/Snippets |
| Create snippet | POST /Templates/Api/Snippets |
| Delete snippet | DELETE /Templates/Api/Snippets/{id} |
| Setup check | GET /Templates/_setup (Development only) |
Theming
The editor ships with a dark theme by default. A ☀ Light / 🌙 Dark toggle button appears in the CANVAS panel heading and persists the preference in localStorage.
The editor's styles are fully scoped to #tb-editor-host — they do not affect the rest of your application. The editing canvas is always white (document-like) regardless of the selected theme.
Template Syntax
Templates use Scriban — access model properties via model.*:
<p>Hello <strong>{{ model.FirstName }}</strong>,</p>
{{ for item in model.Items }}
<p>{{ item.Name }} — {{ item.Price }}</p>
{{ end }}
{{ if model.IsPremium }}
<p>Thank you for being a premium member.</p>
{{ end }}
Render Templates in Code
TemplateBuilder.Editor includes the rendering engine. Inject ITemplateEngine anywhere:
using TemplateBuilder.Domain.Interfaces;
public class WelcomeEmailService(ITemplateEngine engine)
{
public Task<string> BuildAsync(string firstName) =>
engine.RenderByNameAsync("Welcome Email", new { FirstName = firstName });
}
Database
AddTemplateBuilderEditor() registers a hosted service that runs EF Core migrations on startup. No manual migration steps are required.
Static Assets
CSS and JS are served automatically from:
/_content/TemplateBuilder.Editor/css/template-editor.css
/_content/TemplateBuilder.Editor/js/template-editor.js
Your Program.cs must call app.UseStaticFiles() (or app.MapStaticAssets()). After upgrading to a new package version, do a hard refresh (Ctrl+Shift+R) to clear cached assets.
Updating
dotnet add package TemplateBuilder.Editor --version <new-version>
EF migrations are bundled — schema changes apply automatically on next startup.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net10.0
- HtmlSanitizer (>= 9.0.892)
- Microsoft.Data.SqlClient (>= 7.0.1)
- Microsoft.EntityFrameworkCore.SqlServer (>= 10.0.8)
- Scriban (>= 7.2.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.3.4 | 32 | 6/3/2026 |
| 1.3.3 | 44 | 6/2/2026 |
| 1.3.2 | 56 | 6/1/2026 |
| 1.3.1 | 58 | 6/1/2026 |
| 1.3.0 | 50 | 6/1/2026 |
| 1.2.1 | 53 | 6/1/2026 |
| 1.2.0 | 54 | 6/1/2026 |
| 1.1.9 | 52 | 6/1/2026 |
| 1.1.7 | 53 | 5/31/2026 |
| 1.1.6 | 49 | 5/31/2026 |
| 1.1.5 | 54 | 5/31/2026 |
| 1.1.3 | 53 | 5/31/2026 |
| 1.1.2 | 46 | 5/31/2026 |
| 1.1.1 | 52 | 5/30/2026 |
| 1.1.0 | 89 | 5/22/2026 |