TMailr

← All writing

For developers

The feature works. Nobody can tell.

31 July 2026 · 4 min read

A rate limit deferred somebody’s mail and their page said nothing. A destination started bouncing so we paused forwarding, and the page said "paused" as though they had chosen it. A domain stopped verifying so we switched it off, and every alias on it still read "active".

The shape

In each case the mechanism was right, tested and doing exactly its job. What was missing was the sentence on the page the person would actually open when they noticed something wrong.

The rule we now apply

Whenever something can stop work flowing, the surface the user would check has to say that it happened, why, and where the fix is. Not a log line. Not an event in a table. The page.

It is worth grepping your own product for states that block progress and asking, for each, which screen explains it.

More on for developers