Beauty Diagram
Blog

Writing on diagrams

Practical notes on diagrams, docs, and developer ergonomics — published weekly.

AllTutorialOpinionComparisonWorkflowListicleStory
Auto-Generate Architecture Diagrams in CI from Your Spec Files
WorkflowFeatured

Auto-Generate Architecture Diagrams in CI from Your Spec Files

Your architecture diagram is wrong because it's a hand-maintained copy of the system. Here's how to make it a projection instead — generated from files CI already keeps honest.

Jul 27, 202612 min read
Beautify Every Diagram in Your Markdown Docs with One Command
WorkflowJun 15, 2026

Beautify Every Diagram in Your Markdown Docs with One Command

A docs repo has dozens of Mermaid blocks, half on the default pastel theme, some broken. Two commands plus a CI gate render them all to one consistent theme — and keep them that way.

Read article →