axio-intelligence/squatch-mail

SquatchMail is a self hosted dashboard for tracking email sent through Amazon SES, built specifically for Elixir applications using the Phoenix framework. It ships as a regular Hex package rather than a separate service you have to run and maintain, similar in spirit to tools like ErrorTracker or Oban Web. You add it as a dependency, run one database migration, and mount one route, and it starts tracking every email your app sends through SES: a live activity feed, delivery, open, and click tracking, bounce and complaint handling, and a suppression list of addresses that should not be emailed again. The project leans into a lighthearted bigfoot theme throughout its naming: each email sent is called a Sighting, each event it generates is a Footprint, the suppression list is called the Do Not Disturb Registry, and the SES connection screen is called Base Camp. Underneath that theme the actual code and database tables are described as intentionally plain and boring. Technically, SquatchMail attaches to Swoosh's built in telemetry events to observe every email your app already sends, with no changes needed to your existing send path. It receives SES delivery, bounce, complaint, and click notifications through an SNS backed webhook with its own hand verified signature checking, and it can automatically pause sending if your complaint rate crosses a configurable threshold, similar to the limit that would otherwise get your SES account suspended. It also includes one click setup for SES configuration, DNS verification helpers for SPF, DKIM, and DMARC records, and a background job that periodically deletes old email records past a retention period you configure. All of the data lives in its own Postgres schema inside your existing application database, so there is no separate queue, cache, or service to run. The README notes that credential encryption for static AWS keys is not yet finished. Setup is done with a single Igniter install command, and the project is written entirely in Elixir.