Skip to content

Commit e9dfb75

Browse files
authored
docs: align build requirements with CI (#228)
1 parent 754488b commit e9dfb75

1 file changed

Lines changed: 9 additions & 8 deletions

File tree

BUILD.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ make help
2828
```bash
2929
# Build frontend
3030
cd frontend
31-
npm install
31+
npm ci
3232
npm run build
3333
cd ..
3434

@@ -127,12 +127,12 @@ make build-windows-arm64
127127
## Build Requirements
128128

129129
### For Server + Frontend
130-
- **Go 1.25+** - Backend compilation
131-
- **Node.js 18+** - Frontend build
132-
- **npm** - Package management
130+
- **Go 1.27.0** - Exact version declared in `go.mod`
131+
- **Node.js 24.18.0** - Exact version pinned in `.nvmrc` and `frontend/package.json`
132+
- **npm 11.16.0** - Exact version pinned in `frontend/package.json`
133133

134134
### For WS Client Only
135-
- **Go 1.25+** - Client compilation only
135+
- **Go 1.27.0** - Exact version declared in `go.mod`
136136

137137
### For Cross-Compilation (release.sh)
138138
- **Docker + Buildx** - Multi-arch Docker images
@@ -171,10 +171,11 @@ Production builds use these Go build flags:
171171

172172
### Frontend Build Issues
173173
```bash
174-
# Clear npm cache and reinstall
174+
# Reinstall exactly from the lockfile
175175
cd frontend
176-
rm -rf node_modules package-lock.json
177-
npm install
176+
rm -rf node_modules
177+
npm cache verify
178+
npm ci
178179
npm run build
179180
```
180181

0 commit comments

Comments
 (0)