NPv.Mail 2.1.1

NPv.Mail

SMTP and templated email sender implementation for NPv.Mail.Abstractions.

📌 Breaking changes

v2.0.0

• Target framework updated to net10.0 (dropped net9.0 support).

This is a personal library that focuses on the latest .NET runtime to keep maintenance simple and enjoyable.

✨ Overview

NPv.Mail provides a ready-to-use implementation for sending emails and rendering templates:

• 📧 MailKitMailSender – SMTP sender powered by MailKit and MimeKit.
• 📝 ScribanEmailTemplateRenderer – template rendering engine based on Scriban.
• ⚙️ Options binding – strongly typed SmtpSettings with IOptions<T> integration.
• 🔌 Designed for clean architecture – works with NPv.Mail.Abstractions interfaces and fits naturally into DI.

Use this package in your application or infrastructure layers to actually deliver messages defined through abstractions.

🚀 Getting Started

1. Installation

dotnet add package NPv.Mail

You also need the abstractions:

dotnet add package NPv.Mail.Abstractions

2. Configuration

Add SMTP settings to your appsettings.json:

"Smtp": {
  "ServerName": "smtp.example.com",
  "ServerPort": 587,
  "UserName": "user@example.com",
  "Password": "yourpassword",
  "FromAddress": "noreply@example.com",
  "FromName": "Example Sender"
}

3. Register Services

builder.Services.Configure<SmtpSettings>(
    builder.Configuration.GetSection("Smtp"));

builder.Services.AddTransient<IMailSender, MailKitMailSender>();
builder.Services.AddTransient<IEmailTemplateRenderer>(sp =>
    new ScribanEmailTemplateRenderer([typeof(Program).Assembly]));

4. Send an Email

var sender = app.Services.GetRequiredService<IMailSender>();

var message = new MailRequest
{
    To = "recipient@example.com",
    Subject = "Welcome!",
    HtmlBody = "<p>Hello world!</p>",
    Attachments =
    [
        new MailAttachment
        {
            FileName = "hello.txt",
            Content = Encoding.UTF8.GetBytes("Hello world!"),
            ContentType = "text/plain"
        }
    ]
};

await sender.SendAsync(message);

5. Render a Template

var renderer = app.Services.GetRequiredService<IEmailTemplateRenderer>();

var content = renderer.Render(new ConfirmEmailTemplateModel(confirmUrl, "en"));

Console.WriteLine(content.Subject);
Console.WriteLine(content.HtmlBody);

🔗 Related Packages

• NPv.Mail.Abstractions – contracts and DTOs
• NPv.DataAccess.Ef – EF Core repository infrastructure
• NPv.DataAccess.Dapper.Executor – raw SQL execution via Dapper

Author's Note

This library grew out of my long-standing personal interest in structuring and publishing open source packages. Over time, I’ve revisited and refined earlier internal utilities and ideas, giving them a more consistent shape and preparing them for wider reuse. Along the way, I’ve also taken the opportunity to explore how open source distribution and licensing work in the .NET ecosystem.

It’s a small step toward something I’ve always wanted to try — sharing practical, minimal tools that reflect years of learning, experimentation, and refinement.

Hopefully, someone finds it useful.

Nikolai 😛

⚖️ License

MIT — free for commercial and open-source use.