MailVolt

Why MailVolt?

Quick start — zero code

dotnet add package MailVolt.AutoConfigure

{
 "MailVolt": {
 "From": { "Address": "noreply@example.com", "DisplayName": "My App" },
 "Transport": "Smtp",
 "Templates": "Razor",
 "Smtp": {
 "Host": "smtp.example.com",
 "Port": 587,
 "Username": "USER",
 "Password": "PASS"
 }
 }
}

// Program.cs — everything comes from configuration
builder.Services.AddMailVolt(builder.Configuration);

Quick start — explicit registration

dotnet add package MailVolt.Core
dotnet add package MailVolt.Transport.Smtp

using MailVolt.Core.DependencyInjection;
// One using covers AddMailVolt and every transport and template engine.
builder.Services.AddMailVolt()
 .UseSmtpTransport(options =>
 {
 options.Host = "smtp.example.com";
 options.Username = "user";
 options.Password = "pass";
 });

using MailVolt.Core.Interfaces;
public sealed class WelcomeService(IEmailBuilder email)
{
 public async Task SendAsync(string recipient, CancellationToken cancellationToken)
 {
 var result = await email
 .From("sender@example.com")
 .To(recipient)
 .Subject("Hello from MailVolt!")
 .HtmlBody("<h1>Welcome!</h1>")
 .SendAsync(cancellationToken);
 if (result.IsFailure)
 {
 throw new InvalidOperationException(result.Error);
 }
 }
}

Packages

Transports

Templates

Batch sending

using MailVolt.Core.Interfaces;
public sealed class DigestService(IBatchEmailSender batchSender)
{
 public async Task<BatchEmailResult> SendAsync(
 IReadOnlyList<EmailMessage> emails,
 CancellationToken cancellationToken)
 {
 return await batchSender.SendBatchAsync(emails, new BatchSendOptions(
 MaxConcurrency: 10,
 DelayMs: 200,
 FailureStrategy: FailureStrategy.Continue), cancellationToken);
 }
}

Testing

dotnet add package MailVolt.Testing

using MailVolt.Core.DependencyInjection;
using MailVolt.Core.Transports;
using MailVolt.Testing;
var services = new ServiceCollection();
services.AddMailVolt().UseInMemoryTransport();
await using var provider = services.BuildServiceProvider();
var sender = provider.GetRequiredService<InMemorySender>();
await provider.GetRequiredService<WelcomeService>().SendAsync("user@example.com", default);
sender.Should()
 .HaveCount(1)
 .ContainEmailTo("user@example.com")
 .ContainSubject("Welcome!");

Documentation

Versioning and support

Contributing

License