Add 12 ADRs documenting frontend architecture decisions

2026-04-26 16:34:34 +02:00
parent c575992d64
commit 8f2632f456
13 changed files with 302 additions and 0 deletions
@@ -0,0 +1,19 @@
+# ADR 0010: Node Version Management with nvm and .nvmrc
+
+**Date:** 2026-04-26
+**Status:** Accepted
+
+## Context
+
+Angular 21 requires Node.js >= 20.19 or >= 22.12. The system Node version on a development machine may not meet this requirement, causing silent build failures or CLI errors.
+
+## Decision
+
+A `.nvmrc` file at the repository root pins the Node version to `20.19.6`. Developers use `nvm use` to switch to this version. The Husky pre-commit hook explicitly calls `nvm use 20.19.6` before running tests to ensure the correct version is active in the hook's shell environment.
+
+## Consequences
+
+- **Positive:** Consistent Node version across all commands (dev server, build, tests, pre-commit hook).
+- **Positive:** `.nvmrc` documents the required Node version explicitly in the repository.
+- **Constraint:** Requires nvm. Developers using other version managers (fnm, volta) must align manually.
+- **Note:** The `package.json` `engines` field also declares the required Node range (`^20.19.0 || ^22.12.0`) as a secondary signal.