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

33 lines
1.4 KiB
Markdown

# 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:
- `{{name}}` - Subscriber name
- `{{unsubscribe_link}}` - Unsubscribe URL
- `{{preferences_link}}` - Preferences management URL
- `{{website_link}}` - https://agenticgovernance.digital
- `{{docs_link}}` - https://agenticgovernance.digital/docs.html
- `{{github_link}}` - https://github.com/AgenticGovernance/tractatus-framework
- Content-specific variables documented in each template
## 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