Mitc.Email.Templating

Blazor-based email templating service with strongly-typed models and integrated sending via Mitc.Email.Abstractions.

Features

• Blazor component rendering — author email templates as Razor components and render them to HTML strings via HtmlRenderer.
• Typed template base class — EmailTemplateBase<TModel> gives each template a strongly-typed Model parameter.
• Responsive email layout — EmailLayout provides a production-ready HTML email structure with optional heading, header image, footer links, and logo.
• Theming — EmailTheme controls page/card background colors, text color, accent color, logo, and header image. Bind defaults from configuration or set per-request.
• Integrated sending — TemplatedMailService renders a component and sends the result through MailService in a single call.

Registration

builder.AddMitcMailTemplating<MyMailService>();
builder.AddMitcSendGridTransport(); // or another IMailTransport

This registers MailSettings (bound from MailSettings config section), EmailTheme (bound from MailSettings:Branding), HtmlRenderer, MailService, and your TemplatedMailService subclass.

Configuration

{
  "MailSettings": {
    "ServiceMode": "SendAll",
    "FromAddress": "no-reply@example.com",
    "Branding": {
      "AccentColor": "#0066cc",
      "LogoUrl": "https://example.com/logo.png"
    }
  }
}

Usage

1. Define a request model

public class WelcomeMailRequest : SendTemplatedMailRequest
{
    public required string ActivationUrl { get; init; }
}

2. Create a Razor template

@inherits EmailTemplateBase<WelcomeMailRequest>

<EmailLayout Model="Model">
    <p style="margin: 0 0 16px;">Click the link below to activate your account.</p>
    <a href="@Model.ActivationUrl">Activate Account</a>
</EmailLayout>

3. Subclass the service

public class MyMailService(HtmlRenderer htmlRenderer, MailService mailService, IOptions<EmailTheme> themeOptions)
    : TemplatedMailService(htmlRenderer, mailService, themeOptions)
{
    public Task SendWelcomeAsync(WelcomeMailRequest model)
        => SendEmailAsync<WelcomeEmail, WelcomeMailRequest>(model);
}