tractatus/email-templates
TheFlow 3c278c7ade feat: Add Phase 2 newsletter enhancements and email templates
Phase 2 Implementation:
- Add RSS feed discovery links to footer (Subscribe section)
- Create email templates (base-template.html, research-updates-content.html)
- Add comprehensive newsletter sending implementation plan
- Fix CSP check to exclude email-templates directory

Email templates use inline styles for cross-client compatibility
(Gmail, Outlook, Apple Mail) and are excluded from CSP checks.

Next steps: Install dependencies (handlebars, @sendgrid/mail),
implement EmailService, controller methods, and admin UI.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-04 11:13:15 +13:00
..
base-template.html feat: Add Phase 2 newsletter enhancements and email templates 2025-11-04 11:13:15 +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