Email System

Email System Documentation

The Treem DAO platform includes a comprehensive email management system that allows administrators to configure email templates, manage SMTP settings, send bulk emails, and track email analytics.

Overview

The email system provides:

  • Template Management: Create and manage reusable email templates

  • SMTP Configuration: Configure custom email providers or use the default Resend service

  • Bulk Email Sending: Send emails to multiple users or user groups

  • Email Analytics: Track delivery rates, opens, and performance metrics

  • User Preferences: Allow users to control their email subscription preferences

System Architecture

The email system consists of:

  • Frontend Components: Admin interface for email management

  • Edge Function: enhanced-email-service for processing and sending emails

  • Database Tables: Storage for templates, configurations, logs, and preferences

  • Default Provider: Resend service integration for reliable email delivery

Quick Start

For Administrators

  1. Navigate to Admin Dashboard → Settings → Email System

  2. Start with the Templates tab to create your first email template

  3. Optionally configure custom SMTP in the Configuration tab

  4. Use Bulk Send to send emails to users

  5. Monitor performance in Analytics and Recent tabs

For Users

  1. Go to Profile → Email Preferences

  2. Configure which types of emails you want to receive

  3. Toggle notifications for governance, transactions, security, etc.

Table of Contents

  • Template Management

  • SMTP Configuration

  • Bulk Email Sending

  • Email Analytics

  • User Preferences

  • API Reference

  • Troubleshooting

Default Email Provider

The system uses Resend as the default email service provider, which offers:

  • High delivery rates

  • Built-in spam protection

  • Reliable infrastructure

  • Easy integration

When no custom SMTP configuration is active, all emails are sent through Resend.

Security Features

  • Row Level Security (RLS): All email data is protected with proper access controls

  • Admin-only Access: Email management features are restricted to administrators

  • User Privacy: Users can control their email preferences independently

  • Secure Storage: SMTP credentials are securely stored in Supabase

Getting Help

If you encounter issues with the email system:

  1. Check the Troubleshooting Guide

  2. Review email logs in the Recent tab

  3. Verify your SMTP configuration if using custom providers

  4. Ensure your Resend API key is properly configured

Last updated

Was this helpful?