From d7bdff9c7c3a9c8883f1da122f484b5c6dbdc2d7 Mon Sep 17 00:00:00 2001
From: Optic00 <benjamin.busche@gmail.com>
Date: Fri, 28 Aug 2026 23:46:03 +0200
Subject: [PATCH] docs: align build requirements with CI

---
 BUILD.md | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/BUILD.md b/BUILD.md
index 7bcd306f9..e06422115 100644
--- a/BUILD.md
+++ b/BUILD.md
@@ -28,7 +28,7 @@ make help
 ```bash
 # Build frontend
 cd frontend
-npm install
+npm ci
 npm run build
 cd ..
 
@@ -127,12 +127,12 @@ make build-windows-arm64
 ## Build Requirements
 
 ### For Server + Frontend
-- **Go 1.25+** - Backend compilation
-- **Node.js 18+** - Frontend build
-- **npm** - Package management
+- **Go 1.27.0** - Exact version declared in `go.mod`
+- **Node.js 24.18.0** - Exact version pinned in `.nvmrc` and `frontend/package.json`
+- **npm 11.16.0** - Exact version pinned in `frontend/package.json`
 
 ### For WS Client Only
-- **Go 1.25+** - Client compilation only
+- **Go 1.27.0** - Exact version declared in `go.mod`
 
 ### For Cross-Compilation (release.sh)
 - **Docker + Buildx** - Multi-arch Docker images
@@ -171,10 +171,11 @@ Production builds use these Go build flags:
 
 ### Frontend Build Issues
 ```bash
-# Clear npm cache and reinstall
+# Reinstall exactly from the lockfile
 cd frontend
-rm -rf node_modules package-lock.json
-npm install
+rm -rf node_modules
+npm cache verify
+npm ci
 npm run build
 ```