tractatus/email-templates
TheFlow 4833ee1ff9 fix: Complete ProtonBridge email integration with missing templates
- Fix HTML rendering in emails (triple braces for raw HTML in base template)
- Add missing email content templates (project-updates, implementation-notes, governance-discussions)
- Simplify SMTP port detection to respect .env configuration
- Exclude email-templates from CSP validation (inline styles required for email clients)
- Restore EMAIL_FROM to newsletter@agenticgovernance.digital

All templates now exist, emails render correctly, and ProtonBridge integration is complete.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-04 16:28:06 +13:00
..
base-template.html fix: Complete ProtonBridge email integration with missing templates 2025-11-04 16:28:06 +13:00
governance-discussions-content.html fix: Complete ProtonBridge email integration with missing templates 2025-11-04 16:28:06 +13:00
implementation-notes-content.html fix: Complete ProtonBridge email integration with missing templates 2025-11-04 16:28:06 +13:00
project-updates-content.html fix: Complete ProtonBridge email integration with missing templates 2025-11-04 16:28:06 +13:00
README.md feat: Add Phase 2 newsletter enhancements and email templates 2025-11-04 11:13:15 +13:00
research-updates-content.html feat: Add Phase 2 newsletter enhancements and email templates 2025-11-04 11:13:15 +13:00
TEMPLATE_SPECS.md feat: Add comprehensive visitor retention system 2025-11-04 10:42:43 +13:00

Email Templates for Newsletter Tiers

This directory contains HTML email templates for the four newsletter subscription tiers:

  1. research-updates.html - Monthly research insights (scholarly audience)
  2. implementation-notes.html - Bi-weekly implementation guidance (practitioners)
  3. governance-discussions.html - Sporadic values/governance topics (stakeholders)
  4. project-updates.html - Quarterly project milestones (general audience)

Template Variables

All templates use Mustache-style {{variables}} for dynamic content:

Usage

Templates are loaded by the newsletter admin UI and processed with a template engine (e.g., Handlebars, Mustache) before sending via email service.

Design Principles

  • Inline CSS for email client compatibility
  • Responsive design (mobile-friendly)
  • Accessible (semantic HTML, sufficient contrast)
  • Brand-consistent (blue gradient header, clean typography)
  • Clear CTA buttons with good hit targets
  • Unsubscribe link always visible in footer

Template Usage

Base Template (base-template.html)

The base template provides the outer HTML structure with header, footer, and styling. It uses these placeholders:

  • {{email_title}} - Email subject (for