News

Home of my newsletters

Features:

• 🖌️ Easily create with liquid templates & mjml for email compatibility
• 👁️ Email open analytics with integrated pixel tracking server
• 📋 Subscribe/unsubscribe
• 📤 Automated bulk sending
• ⚙️ Easy to repurpose for yourself, can run entirely in GitHub

Developing

Web

1. pnpm install
2. pnpm dev
3. Deployments are made automatically on push to GitHub

Server (optional)

1. Install rust toolchain (rustc, cargo)
2. cd target/debug
3. cargo run or cargo build --release

Mailer (python script)

1. Install python
2. pip install dotenv tqdm requests OR install dependancies with pdm add
3. cp .sample.env .env
4. Make & populate recipients.csv with format <name>,<email>
5. python3 newsletter-mailer.py (will confirm before sending)

Newsletter formatting

• 2-column body images are square & resized to 250x250 (use the "fill" option)
• 3-column body images are square & resized to 150x150
• The smallest edge of the hero image is resized to 512 (use the "fit" option of PowerToys image resizer)

Personalization

The mailer script makes the following substitutions:

• $name: Recipient name
• $tracking: Recipient name, URI encoded
• $email: Recipient email, used for unsubscribing
• $address: Sender's physical address, read from .env

Server endpoints

• /hello/<info>: Tracking pixel which logs iso_datetime, ip, user_agent, info to access.csv
• /subscribe/<email>/<name>: Adds name,email to recipients.csv
• /unsubscribe/<email>: Removes email from recipients.csv