tractatus/email-templates/README.md
TheFlow 4408b694f9 feat: Add comprehensive visitor retention system
Implemented RSS feeds, newsletter subscriptions, email templates, and admin UI
to encourage repeat visits from self-selected visitors.

## RSS Feeds
- Created RSS 2.0 feed generation (main + topic-specific)
- Endpoints: /feed.xml and /feed/:topic.xml
- Added getPublished() and getPublishedByTag() to BlogPost model

## Newsletter Subscriptions
- Created reusable newsletter modal component
- Added to index, researcher, implementer, leader pages
- Interest selection: research, implementation, governance, project-updates
- Added newsletter trigger button to footer
- Uses existing /api/newsletter/subscribe endpoint

## Email Templates
- Created comprehensive specifications for 4 newsletter tiers
- Research Updates (monthly) - scholarly audience
- Implementation Notes (bi-weekly) - practitioners
- Governance Discussions (sporadic) - stakeholders
- Project Updates (quarterly) - general audience
- Documented template variables, design guidelines

## Admin UI
- Enhanced newsletter management with "Send Newsletter" section
- Tier selection, subject/preview input, JSON content editor
- Preview/test/send buttons (UI ready, email service TBD)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-04 10:42:43 +13:00

1.4 KiB

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