supabase + smtp relay

Author: pierre-b

assets/integrations/supabase-notifuse.png

@@ -237,6 +237,52 @@ Send files with your transactional emails such as invoices, receipts, tickets, o
 - **Reports**: Attach analytics reports and summaries
 - **Certificates**: Attach completion certificates and badges
 
+## SMTP Relay
+
+Notifuse includes a built-in SMTP relay server that allows you to send transactional emails using standard SMTP clients instead of HTTP API calls. This is particularly useful when:
+
+- **Legacy Systems**: Integrating with existing applications that only support SMTP
+- **Email Libraries**: Using standard email libraries in any programming language
+- **Framework Integration**: Working with frameworks that have built-in SMTP support
+- **Gradual Migration**: Moving from existing email providers without changing application code
+
+### How It Works
+
+The SMTP relay server accepts emails via SMTP with TLS encryption on port 587. The email body must contain a JSON payload matching the Transactional API format. Authentication is done using your workspace API credentials.
+
+### Sending Emails via SMTP
+
+#### Authentication
+
+- **Username**: Your workspace API email (the email associated with your API key)
+- **Password**: Your workspace API key
+- **Security**: STARTTLS (port 587)
+- **Server**: Your configured SMTP relay host (e.g., `smtp.yourdomain.com`)
+
+#### Email Format
+
+The email body must be a JSON payload matching the Transactional API format:
+
+```json
+{
+  "workspace_id": "your_workspace",
+  "notification": {
+    "id": "password_reset",
+    "external_id": "unique-id-123",
+    "channels": ["email"],
+    "contact": {
+      "email": "[email protected]",
+      "first_name": "John",
+      "last_name": "Doe"
+    },
+    "data": {
+      "reset_token": "abc123",
+      "expiry_time": "1 hour"
+    }
+  }
+}
+```
+
 ## Template Integration
 
 ### Data Structure in Templates

assets/integrations/supabase.png

@@ -40,6 +40,10 @@
             "group": "Tutorials",
             "pages": ["tutorials/newsletter-form-input"]
           },
+          {
+            "group": "Integrations",
+            "pages": ["integrations/supabase"]
+          },
           {
             "group": "Email Providers",
             "pages": [

assets/screenshots/supabase/supabase_endpoints.png

@@ -102,6 +102,21 @@ Notifuse supports multiple email service providers, giving you flexibility and r
   </Card>
 </CardGroup>
 
+## Platform Integrations
+
+Seamlessly integrate Notifuse with your existing tools and workflows:
+
+<CardGroup cols={3}>
+  <Card title="Supabase" href="/integrations/supabase">
+    <img
+      src="/assets/integrations/supabase.png"
+      alt="Supabase"
+      className="w-full h-6 object-contain my-6"
+    />
+    Auth emails and user sync integration
+  </Card>
+</CardGroup>
+
 ## Getting Started
 
 <CardGroup cols={2}>