mjml-email-templates

1# MJML Email Templates
2 
3## When to Use This Skill
4 
5Use this skill when:
6- Building transactional emails (signup, password reset, invoices, notifications)
7- Creating responsive email templates that work across clients
8- Setting up MJML template rendering in .NET
9 
10**Related skills:**
11- `aspire/mailpit-integration` - Test emails locally with Mailpit
12- `testing/verify-email-snapshots` - Snapshot test rendered HTML
13 
14---
15 
16## Why MJML?
17 
18**Problem**: Email HTML is notoriously difficult. Each email client (Outlook, Gmail, Apple Mail) renders differently, requiring complex table-based layouts and inline styles.
19 
20**Solution**: [MJML](https://mjml.io/) is a markup language that compiles to responsive, cross-client HTML:
21 
22```mjml
23<!-- MJML - simple and readable -->
24<mj-section>
25  <mj-column>
26    <mj-text>Hello {{UserName}}</mj-text>
27    <mj-button href="{{ActionUrl}}">Click Here</mj-button>
28  </mj-column>
29</mj-section>
30```
31 
32Compiles to ~200 lines of table-based HTML with inline styles that works everywhere.
33 
34---
35 
36## Installation
37 
38### Add Mjml.Net
39 
40```bash
41dotnet add package Mjml.Net
42```
43 
44### Embed Templates as Resources
45 
46In your `.csproj`:
47 
48```xml
49<ItemGroup>
50  <EmbeddedResource Include="Templates\**\*.mjml" />
51</ItemGroup>
52```
53 
54---
55 
56## Project Structure
57 
58```
59src/
60  Infrastructure/
61    MyApp.Infrastructure.Mailing/
62      Templates/
63        _Layout.mjml              # Shared layout (header, footer)
64        UserInvitations/
65          UserSignupInvitation.mjml
66…