Skip to main content

Emails

OneStarter gives you a foundation for:

  • Building your email templates for transactional emailing
  • Sending transactional emails
  • Webhook access for sending transactional emails from Supabase

One of the key concepts to remember is that these are not marketing emails; they are emails triggered based on usage of the platform. Do not abuse this when designing your business technically, treat marketing emails differently.

Configuring Transactional Emails for Supabase​

The application is configured out of the box to support Supabase's auth webhook email sending. For local development, you do not need to do anything.

info

Cloudflare workers are not able to make SMTP requests, so for local development we use an email-bride service (found in /backend/services/email-bridge). This is used to send an SMTP request to the locally running InBucket service provided by Supabase.

For Staging and Production, you will need to ensure the Webhook secret used in Supabase's auth hook configuration is shared with the Backend when deploying. This is very important since this is how your backend authenticates that the request is from a trusted source. Ensure you treat this as a secret.