managarten/apps-archived/uload/docs/EMAIL_SETUP.md

Email Configuration Guide for ulo.ad

The team invitation system is fully implemented and ready to send emails. To enable actual email sending, choose one of the following options:

Option 1: PocketBase SMTP (Recommended) ⭐

1. Access PocketBase Admin Panel

   • Go to: https://pb.ulo.ad/_/
   • Login with your admin credentials

2. Navigate to Mail Settings

   • Go to Settings → Mail settings
   • Or direct link: https://pb.ulo.ad/_/#/settings/mail

3. Configure SMTP

   • Enable "Use SMTP mail server"
   • Enter your SMTP details:

   For Gmail:

   • SMTP Host: smtp.gmail.com
   • Port: 587
   • Username: Your Gmail address
   • Password: Generate an App Password
   • Use TLS: ✅

   For Outlook/Hotmail:

   • SMTP Host: smtp-mail.outlook.com
   • Port: 587
   • Username: Your Outlook email
   • Password: Your password
   • Use TLS: ✅

   For Custom Domain (e.g., Zoho, FastMail):

   • Check your email provider's SMTP settings

4. Save Settings

   • Click "Save changes"
   • Test by inviting a team member

Option 2: Brevo (Free - 300 emails/day)

1. Sign up at Brevo

2. Get your API key

   • Go to: https://app.brevo.com/settings/keys/api
   • Copy the API key

3. Add to .env

   BREVO_API_KEY=your-api-key-here
   

4. Update /src/lib/services/email-sender.ts

   • Uncomment the Brevo code section (lines 35-50)
   • Comment out the console.log section

Option 3: Resend (Free - 100 emails/day)

1. Sign up at Resend

2. Verify your domain

3. Get your API key

4. Add to .env

   RESEND_API_KEY=your-api-key-here
   

5. Update /src/lib/services/email-sender.ts

   • Uncomment the Resend code section (lines 52-66)
   • Comment out the console.log section

Testing Email Setup

1. Restart the dev server (if you added environment variables)

   npm run dev
   

2. Test invitation flow:

   • Go to Settings → Team Management
   • Invite a team member by email
   • Check the console/logs to see if email was sent
   • Check recipient's inbox

Current Status

✅ Email templates are ready ✅ Invitation flow is complete ✅ Email logging is active (you'll see emails in console) ⏳ SMTP configuration needed (choose one option above)

Email Templates Included

1. Team invitation for existing users - Sent when inviting registered users
2. Team invitation for new users - Sent when inviting non-registered emails
3. Invitation accepted notification - Sent to owner when invitation is accepted

All templates are bilingual (German/English) and mobile-responsive.

Troubleshooting

• Emails not sending? Check PocketBase logs: Admin → Logs
• SMTP errors? Verify credentials and port settings
• Gmail blocking? Use App Password, not regular password
• Rate limits? Free tiers have daily limits

For production, we recommend using PocketBase SMTP with a professional email service like SendGrid, Mailgun, or Amazon SES.