DecisionUse gatsby-theme-adr to manage the ADRs


We need a site generator to publish our ADRs.

Table Of Contents


We will use Gatsby along with a gatsby subtheme to generate a website for

We initially used log4brains which met many of our needs. However, it did not support key features like embedding local images, and went through a through a period of minimal maintainership. Our team determined that creating our own theme would be more effective for our needs.


We have expanded the possible scope for our team from being simply "users" of ADR generator to developers and maintainers. We will need to respond to bug reports and feature requests in a timely manner.

Andrew Berry, Mateu Aguiló Bosch

Decided on