Introduction

What is Oxidt Mail?

Oxidt Mail is a newsletter app for your own Amazon SES account: write an issue, send it to your list, publish it on the web. You pay SES for the emails you send, about $0.10 per 1,000, and your list stays in your PostgreSQL database.

Tip

Everything compiles to one binary: an Axum server whose pages Topcoat renders, plus a small hashed asset bundle. Sending runs on PostgreSQL background jobs, so there is no queue service to set up.

Features

Write and send

Markdown or designed HTML with a preview, test emails, scheduling, and sending in steps to the most engaged readers first.

Grow the list

Several newsletters per organization, an archive signup form, a signup API, confirmed opt-in, welcome emails and CSV import.

Keep it healthy

Bounces and complaints suppress addresses, sends pause above 2% bounces or 0.08% complaints, every email has one-click unsubscribe.

Publish and measure

A public archive per newsletter, opens and clicks on your own domain, and reports by mailbox provider.

Project Structure

core/                # mail-core: rendering, signed links, tracking, SES/SNS rules (no I/O)
app/src/
├── web/             # Topcoat pages: overview, newsletters, campaigns, contacts, archive
└── server/mail/     # storage, sending jobs, SES/SMTP delivery, webhooks, API

Next Steps

Installation

Run Oxidt Mail locally with Mailpit.

Sending with SES

Verify a domain, wire up bounces and complaints, turn sending on.

API

Add contacts from your site and create drafts from scripts.

Authentication

Email codes and passkeys by default, FerrisKey OIDC when you need SSO.