Email Blog Platform

A modern blog platform inspired by Posterous that allows publishing posts via email.

Your email blog platform is fully functional! Send an email to start publishing.

• 📧 Email-to-Publish: Send an email to publish posts instantly
• 🔒 Email Security: Allowlist and verification system to prevent unauthorized posts
• 🎨 Multi-format Support: HTML and plain text posts
• 📡 RSS Feed: Full RSS 2.0 support for syndication
• 🌐 WebSub: Real-time feed updates via WebSub protocol (configured)
• 🐘 ActivityPub: Full federated social networking with followers, likes, and shares ✅
• 🦋 AT Protocol: Bluesky integration for cross-platform syndication (configured)
• 🔗 SEO Friendly: Clean URLs with slugified titles
• 📱 Responsive Design: Mobile-first responsive interface with TailwindCSS
• ⚡ Fast: Built on Val Town with SQLite storage and static HTML generation
• 🚀 No JavaScript: Pure HTML/CSS frontend for maximum performance

• index.ts - Main Hono server with HTML generation and API routes ✅
• database/ - SQLite schema and query functions ✅
• services/ - External service integrations ✅

• Email trigger handler with security verification ✅
• Allowlist checking and draft post creation ✅
• Automated verification email sending ✅

• Server-side HTML rendering with TailwindCSS ✅
• No client-side JavaScript dependencies ✅
• Fast loading and SEO optimized ✅

1. Configure Security: Set ALLOWED_EMAIL_ADDRESSES environment variable (see Security section)
2. Send Email: Send email from an allowed address to your Val Town email address
3. Verify Email: Click the verification link sent to your email
4. View Blog: Visit your backend HTTP val URL after verification
5. RSS Feed: Access /rss for syndication
6. Individual Posts: Visit /post/[slug]

See SETUP.md for detailed setup instructions and ACTIVITYPUB.md for ActivityPub federation details.

• ALLOWED_EMAIL_ADDRESSES - Comma-separated list of allowed email addresses (required)
• BASE_URL - Your blog's base URL for verification links (optional, auto-detected)

• WEBSUB_HUB_URL - WebSub hub URL
• ACTIVITYPUB_DOMAIN - Domain for ActivityPub federation
• ATPROTO_HANDLE - AT Protocol handle
• ATPROTO_PASSWORD - AT Protocol app password

• GET / - Main blog interface
• GET /post/:slug - Individual post page
• GET /rss - RSS 2.0 feed
• GET /api/posts - JSON API for posts
• GET /api/posts/:slug - JSON API for single post
• GET /websub - WebSub subscription endpoint
• GET /.well-known/webfinger - WebFinger discovery for ActivityPub ✅
• GET /actor - ActivityPub actor document ✅
• GET /outbox - ActivityPub outbox (published activities) ✅
• GET /followers - ActivityPub followers collection ✅
• GET /following - ActivityPub following collection ✅
• POST /inbox - ActivityPub inbox (processes Follow, Like, Announce, Undo) ✅
• GET /api/posts/:slug/activities - Get activity counts (likes, shares, replies) ✅
• GET /verify-email - Email verification endpoint ✅
• GET /health - Health check

Only emails from pre-configured addresses can publish posts. Configure via environment variable:

ALLOWED_EMAIL_ADDRESSES=user1@example.com,user2@example.com,admin@myblog.com

To prevent spoofing, all emails go through a verification process:

1. Email Received: Email is stored as a draft (not published)
2. Verification Sent: Automated verification email sent to sender
3. User Clicks Link: Sender clicks verification link in email
4. Post Published: After verification, post is published and syndicated

• Anti-spoofing: Prevents unauthorized users from publishing posts
• Email confirmation: Ensures the sender actually sent the email
• Time-limited: Verification links expire after 24 hours
• Automatic cleanup: Expired drafts are automatically removed

Use /test-publish.ts to create sample posts for testing.

Send an email like this:

To: your-email-val@val.town
From: allowed-user@example.com  (must be in ALLOWED_EMAIL_ADDRESSES)
Subject: My Amazing Blog Post
Body: <h2>Hello World!</h2><p>This post was published via email!</p>

The process will be:

1. Email received and stored as draft
2. Verification email sent to allowed-user@example.com
3. User clicks verification link
4. Post published with:
   • Title: "My Amazing Blog Post"
   • Slug: "my-amazing-blog-post"
   • Content: Rendered HTML
   • Author: Extracted from email address

• Edit HTML generation functions in /backend/index.ts
• Modify CSS styles in the getCustomCSS() function
• Update branding in HTML templates
• Configure federation services via environment variables

Posts are automatically syndicated to:

• RSS feed (always enabled)
• WebSub subscribers (if configured)
• ActivityPub followers (with full interaction support) ✅
• AT Protocol/Bluesky (if configured)

Your blog is now fully federated with ActivityPub! Users can:

• Follow your blog from Mastodon, Pleroma, and other ActivityPub platforms
• Like your blog posts (shows ❤️ count on posts)
• Share/Boost your posts (shows 🔄 count on posts)
• Reply to your posts (shows 💬 count on posts)

Discovery formats:

• WebFinger: @blog@your-domain.com
• Direct actor URL: https://your-domain.com/actor

Real-time interaction tracking:

• All likes, shares, and replies are stored and displayed on individual post pages
• Follower count is maintained and accurate
• Full ActivityPub inbox processing for Follow/Unfollow activities

Example: If your blog is at myblog.web.val.run, users can follow @blog@myblog.web.val.run from their Mastodon client and interact with your posts!

Ready to blog via email? Send your first post now! 📧✨