Log4brains
Tool for logging architecture decision records (ADRs) and publishing them as a static website.
Log4brains is a docs-as-code knowledge base for architecture decision records (ADRs). The records are markdown files stored in the project’s git repository, written from the IDE or created from the command line. A local preview with hot reload shows the knowledge base while it is edited, and a build publishes it as a static website to a static host such as GitHub Pages, GitLab Pages or S3.
The README lists searchable records, a timeline menu, a customizable template (MADR by default) and support for mono and multi package projects.
Worth knowing
The project has no website of its own beyond the repository. The README’s own example knowledge base shows what the published output looks like.
Identity
- Status
- Active
- Maintainer
- Thomas Vaillant2
- Maintained by
- Individual
Rendering and deploy
- Runs as
- Static files, Dev only2
- Rendering
- Static output2
- Install with
- npm install -g log4brains2
Releases
Adoption
Sources
- 2026-10-21: links, Written in, License, GitHub stars
api.github.com/repos/thomvaill/log4brains - 2026-10-21: Categories, Runtime, Install with, Rendering, Runs as, Maintainer, Content storage
raw.githubusercontent.com/thomvaill/log4brains/develop/README.md - 2026-10-21: Minimum runtime, Current major version
registry.npmjs.org/log4brains - 2026-10-21: Last release
api.github.com/repos/thomvaill/log4brains/releases/latest - 2026-10-21: npm downloads a week
api.npmjs.org/downloads/point/last-week/log4brains - 2026-10-25: Dependent repositories, Dependent packages
packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/log4brains