Christian: the current ASCII diagram renders tiny on mobile. Three replacement options below, all inline SVG (no JS dependency, edits in the markdown source, renders identically on desktop and mobile). Pick one and I ship. Or say "none of these" and I try a Gemini-generated illustrated version.
Current state (for reference)
This is what ships today. Tiny, no color, no visual hierarchy. Legible but not memorable.
customer email
|
v
[hi@<their-domain>.com IMAP mailbox]
|
| (MailBridge polls every 5 min)
v
[MailBridge worker] ---- signed webhook (HMAC-SHA256) ----> [operator's review agent]
|
(the agent drafts a reply)
|
v
[draft proposed in Telegram chat]
|
(operator replies "send")
|
v
[POST /api/v1/connections/:id/send]
|
v
[MailBridge submits via source SMTP]
|
v
reply lands in customer's inbox +
appears in Sent folder of hi@<their-domain>
Three color-coded phase cards (INBOUND / AGENT / OUTBOUND) stacked vertically. Each card shows its steps. Arrows between cards signal flow. Fits mobile natively (SVG scales). Feels professional.
Option B: Compact horizontal (3 columns)
Left-to-right flow: source โ agent โ destination. Works on wide screens; on mobile it scales down (SVG viewBox). More at-a-glance, less detail per step.
Option C: Hand-drawn (Excalidraw aesthetic)
Same content as Option A but with a rough, playful hand-drawn look. Feels artisanal, less corporate. Good for HN/blog audiences.
Comparison
Aspect
Current ASCII
A: Clean SVG
B: Horizontal
C: Hand-drawn
Mobile legibility
Poor
Excellent
Good (scales)
Excellent
Visual polish
None
Professional
Professional
Playful
HN/tech-audience fit
OK
Strong
Strong
Very strong (differentiator)
Editable in markdown source
Yes
Yes (inline SVG)
Yes (inline SVG)
Yes (inline SVG)
Extra dependencies
None
None
None
None
Bytes added
~0.7kb
~3.5kb
~3kb
~3.5kb
My recommendation
Option A (Clean vertical SVG). Fits HN's audience without feeling corporate. Reads top-to-bottom which matches how mobile users scroll. The three phase strips make the pipeline shape obvious in one glance. Inline in the markdown so I can edit it if the pipeline changes.
If you want more personality, Option C. If you want the widest desktop use of horizontal space, Option B.
Tell me A, B, C, or "try Gemini for an illustrated version" and I ship.