# Log4brains

Tool for logging architecture decision records (ADRs) and publishing them as a static website.


Source: https://findsoftware.frbit.cloud/log4brains/
Last reviewed: 2026-10-21
Updated: 2026-10-25
Listed since: 2026-10-21

## Record

### Links

- repository: https://github.com/thomvaill/log4brains

### Identity

- status: active
- maintainer: Thomas Vaillant
- maintainerType: individual
- parent: unknown
- firstRelease: unknown
- hqCountry: unknown

### Kind

- category: ssg
- hosting: static
- language: javascript
- runtime: node
- runtimeMin: node 18
- basedOn: unknown

### Content

- contentStore: flat-file
- databases: unknown
- adminUi: unknown
- headlessApi: unknown
- templating: unknown
- i18n: unknown

### Rendering and deploy

- runsAs: static, local
- renderingModes: static
- installMethod: npm install -g log4brains

### License

- licenseModel: open-source
- license: Apache-2.0

### Releases

- currentMajor: 1
- latestReleaseDate: 2024-12-17

### Adoption

- githubStargazers: 1603
- packagistDownloads: not applicable
- npmWeeklyDownloads: 1670
- contributors: unknown
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 4
- dependentPackages: 4

### Sources

- urls: https://api.github.com/repos/thomvaill/log4brains (read 2026-10-21)
- category: https://raw.githubusercontent.com/thomvaill/log4brains/develop/README.md (read 2026-10-21)
- language: https://api.github.com/repos/thomvaill/log4brains (read 2026-10-21)
- runtime: https://raw.githubusercontent.com/thomvaill/log4brains/develop/README.md (read 2026-10-21)
- runtimeMin: https://registry.npmjs.org/log4brains (read 2026-10-21)
- installMethod: https://raw.githubusercontent.com/thomvaill/log4brains/develop/README.md (read 2026-10-21)
- renderingModes: https://raw.githubusercontent.com/thomvaill/log4brains/develop/README.md (read 2026-10-21)
- runsAs: https://raw.githubusercontent.com/thomvaill/log4brains/develop/README.md (read 2026-10-21)
- runsAs: https://raw.githubusercontent.com/thomvaill/log4brains/develop/README.md (read 2026-10-21)
- license: https://api.github.com/repos/thomvaill/log4brains (read 2026-10-21)
- maintainer: https://raw.githubusercontent.com/thomvaill/log4brains/develop/README.md (read 2026-10-21)
- currentMajor: https://registry.npmjs.org/log4brains (read 2026-10-21)
- latestReleaseDate: https://api.github.com/repos/thomvaill/log4brains/releases/latest (read 2026-10-21)
- githubStargazers: https://api.github.com/repos/thomvaill/log4brains (read 2026-10-21)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/point/last-week/log4brains (read 2026-10-21)
- contentStore: https://raw.githubusercontent.com/thomvaill/log4brains/develop/README.md (read 2026-10-21)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/log4brains (read 2026-10-25)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/log4brains (read 2026-10-25)

## Notes

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.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0