HtmlForgeX

Getting Started with HtmlForgeX.Email

Step 1: Install

dotnet add package HtmlForgeX.Email

Step 2: Create an Email

using HtmlForgeX.Email;

var email = new Email();

Step 3: Configure Theme

email.WithThemeMode(EmailThemeMode.Auto);
email.ConfigureLayout(maxWidth: "680px");

Step 4: Add Content

email.Body.EmailBox(box => {
    box.EmailHeading("Order Confirmation", 1);
    box.EmailText(text => text.Text("Your order #12345 has been confirmed."));

    box.EmailKeyValueTable(table => {
        table.AddRow("Order Number", "#12345");
        table.AddRow("Date", "January 15, 2026");
        table.AddRow("Total", "$149.99");
    });

    box.EmailButton(button => {
        button.WithText("Track Order")
              .WithHref("https://example.com/track")
              .WithStyle(EmailButtonStyle.Primary);
    });
});

Step 5: Render

var result = await email.RenderAsync();
string html = result.Html;
// Send via your email service

API Reference