How to use BlazorTemplater for email templates with CSS?

BlazorTemplater renders Razor Components to HTML, but for emails, you must pre-process CSS using external libraries like PreMailer.NET to inline styles, as email clients have limited support and the library doesn't handle CSS internally.

BlazorTemplater vs RazorLight: which is better for .NET templating?

BlazorTemplater is better if you're already using Razor Components and want compile-time advantages with type safety; RazorLight is suited for legacy Razor Views (.cshtml) in non-Blazor contexts but may have slower runtime compilation.

Can I use BlazorTemplater in a console application?

Yes, it works with .NET Core 3.1, .NET 5, and .NET 6, but you need to enable Razor SDK in your project to compile .razor files, which might require additional setup steps as outlined in the documentation.

How do I inject services into a component with BlazorTemplater?

Use the .AddService () method on ComponentRenderer to provide service instances, or add a custom IServiceProvider via .AddServiceProvider() for reusing services across multiple renders, as shown in the dependency injection examples.

Does BlazorTemplater support nested components and layouts?

Yes, it supports nested components and layouts either via the @layout attribute in components or explicitly using .UseLayout(), allowing for hierarchical template structures for consistent output.

BlazorTemplater

Apache-2.0C#

A .NET library that renders Razor Components to HTML strings, ideal for generating email templates and other HTML content.

GitHub

What is BlazorTemplater?

BlazorTemplater is a .NET library that enables server-side rendering of Razor Components into HTML strings. It provides a simple and efficient way to generate HTML content, such as email templates, outside of a Blazor web application context. It leverages the compile-time advantages of Razor Components over traditional runtime-compiled Razor Views for faster and more flexible HTML generation.

Target Audience

.NET developers who need to generate HTML from Razor Components in non-web contexts, such as for email templating, report generation, or static content creation. It is particularly useful for those already using Blazor and wanting to reuse component logic outside of a Blazor app.

Value Proposition

Developers choose BlazorTemplater because it offers a fluent API with type-safe parameter injection, dependency injection support, and layout capabilities, making it more intuitive and flexible than older Razor View-based solutions. It works with standard Razor Components, providing full tooling support and compatibility across .NET Standard 2.0/2.1, .NET Core 3.1, and .NET 5/6.

Overview

A library that generates HTML (e.g. for emails) from Razor Components

Use Cases

Best For

Related Projects

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub

163 stars19 forks0 contributors

Generating HTML email templates using Razor Components with dynamic data binding.

Creating static HTML content from Blazor components for reports or documentation outside a web app.

Reusing Blazor component logic in backend services or console applications for HTML rendering.

Building email systems that require dependency injection into components for service integration.

Developing templates with layouts and nested components for consistent HTML output.

Migrating from older Razor View-based templating libraries to a compile-time Razor Component approach.

Not Ideal For

Projects requiring interactive UI components with JavaScript events or EventCallbacks, as it only renders static HTML.
Email templating systems needing automatic CSS inlining and styling without integrating external preprocessing libraries.
Applications heavily reliant on client-side Blazor (WASM) features for real-time updates or dynamic rendering.

Pros & Cons

Pros

Fluent API Simplicity

The ComponentRenderer uses a fluent interface for easy chaining of operations like .Set() and .AddService(), making configuration intuitive and readable, as demonstrated in the README examples.

Type-Safe Parameter Injection

Allows setting component parameters with lambda expressions that ensure type safety at compile time, reducing runtime errors and improving developer experience.

Dependency Injection Support

Components can use @inject with services provided via .AddService() or a custom IServiceProvider, enabling seamless integration with existing dependency injection containers.

Layout Flexibility

Supports layouts through the @layout attribute or explicit .UseLayout() method, allowing for consistent HTML structures across components, as detailed in the Layouts documentation.

Cons

No Interactive Features

The README explicitly states limitations: it does not support JavaScript, EventCallbacks, or rerendering, restricting use to static HTML generation only.

CSS Handling Requires External Tools

As admitted in the README, CSS support is not included, and for email templating, additional libraries like PreMailer.NET are needed to inline styles, adding complexity.

Setup Complexity for Non-Blazor Projects

Requires enabling Razor SDK in projects, which can be non-trivial for .NET Standard libraries without existing Razor support, as noted in the 'Getting Started' guide.

Frequently Asked Questions

Home

Blazor

Fluxor

Fluxor is a zero boilerplate Flux/Redux library for Microsoft .NET and Blazor.

Stars1,470

Forks164

Last commit1 day ago

Blazored.LocalStorage

A library to provide access to local storage in Blazor applications

Stars1,331

Forks134

Last commit1 year ago

bUnit - a testing library for Blazor components

bUnit is a testing library for Blazor components that make tests look, feel, and runs like regular unit tests. bUnit makes it easy to render and control a component under test’s life-cycle, pass parameter and inject services into it, trigger event handlers, and verify the rendered markup from the component using a built-in semantic HTML comparer.

A Blazor State management library by TimeWarp.

Stars613

Forks57

Last commit4 months ago

#email-templates

#fluent-interface

#razor-components

#server-side-rendering

#dependency-injection