Swoosh Emails

RULES — Follow these with no exceptions

1. Use Swoosh for all email sending
2. Define emails in separate modules — MyApp.Emails.UserEmail, not inline in contexts
3. Use Phoenix components for email templates — reuse UI components in emails
4. Configure delivery per environment — Local adapter in dev/test, real adapter in prod
5. Test emails with Swoosh.TestAssertions — assert emails were sent with correct content
6. Never send emails synchronously in web requests — use Oban or Task for async delivery
7. Use Swoosh.Preview in development — preview emails in the browser
8. Prefer Oban over Task.start — retries and observability vs silent failures

Setup