Skip to content

Self-hosted monitoring for homelabs: host and container metrics and uptime checks from all your machines in one dashboard, with an optional AI agent that diagnoses incidents and suggests fixes.

chore: move the frontend build from Node 20 to Node 24 LTS (#228)

Karlo Kajba Šimanić31c72e3469bd
diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index e82c537..af28a90 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -3,7 +3,7 @@ infradeck: a self-hosted dashboard for monitoring homelab machines. One machine
## Stack
- Backend: Python 3.12, FastAPI + Uvicorn, SQLAlchemy + Alembic, PostgreSQL 16 (psycopg), Redis (sessions, rate limits, agent job queue). Tests: pytest.
-- Frontend: React 19, react-router-dom 7, Vite 8, Tailwind CSS v4, oxlint, Node 20, served by nginx. Tests: `node --test`.
+- Frontend: React 19, react-router-dom 7, Vite 8, Tailwind CSS v4, oxlint, Node 24, served by nginx. Tests: `node --test`.
- Collectors: Python 3.12, standard library only.
- Infra: Docker Compose, nginx (frontend + collector-gate), optional Traefik/Caddy, signed collector images on GHCR (cosign), GitHub Actions CI.
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 7c49911..d8b976d 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -1,5 +1,5 @@
-# Runs the backend tests, the frontend helper tests and the frontend linter on every pull request and on pushes
-# to main. Needs no services: the backend tests use an in-memory database and fakes (see TESTS.md).
+# Runs the backend tests, the frontend helper tests, the frontend linter and the frontend build on every pull
+# request and on pushes to main. Needs no services: the backend tests use an in-memory database and fakes (see TESTS.md).
# Third-party actions are pinned to commit hashes; update them deliberately.
name: Tests
@@ -37,9 +37,10 @@ jobs:
persist-credentials: false
- uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
- node-version: "20"
+ node-version: "24"
cache: npm
cache-dependency-path: src/frontend/package-lock.json
- run: npm ci
- run: node --test
- run: npx oxlint
+ - run: npm run build
diff --git a/.nvmrc b/.nvmrc
index 209e3ef..a45fd52 100644
--- a/.nvmrc
+++ b/.nvmrc
@@ -1 +1 @@
-20
+24
diff --git a/README.md b/README.md
index 1612e46..9b50820 100644
--- a/README.md
+++ b/README.md
@@ -217,7 +217,7 @@ Everything is in [`docs/`](docs/README.md):
## Development and tests
-Backend (Python 3.12) and frontend (Node 20) can run without Docker; see [Development](docs/development.md).
+Backend (Python 3.12) and frontend (Node 24) can run without Docker; see [Development](docs/development.md).
```bash
source venv/bin/activate && pip install -r requirements-dev.txt && pytest # backend, about four minutes
diff --git a/TESTS.md b/TESTS.md
index 09b0944..0e86268 100644
--- a/TESTS.md
+++ b/TESTS.md
@@ -1496,7 +1496,7 @@ agent's look-up steps) are plain JavaScript with no dependencies, so they have t
Node's built-in runner:
```bash
-cd src/frontend && node --test # Node 20 or newer; nothing to install
+cd src/frontend && node --test # Node 24 or newer; nothing to install
```
| File | Tests | What they protect |
diff --git a/docker/frontend.Dockerfile b/docker/frontend.Dockerfile
index 4dad40f..8efe03d 100644
--- a/docker/frontend.Dockerfile
+++ b/docker/frontend.Dockerfile
@@ -1,4 +1,4 @@
-FROM node:20.20.2-alpine@sha256:fb4cd12c85ee03686f6af5362a0b0d56d50c58a04632e6c0fb8363f609372293 AS build
+FROM node:24.22.3-alpine@sha256:98e4e60b35fd50143e1838da2957488c25aa3a3efbd48bb679923f77d6d3d873 AS build
WORKDIR /app
diff --git a/docs/development.md b/docs/development.md
index 4dd01ef..2262af5 100644
--- a/docs/development.md
+++ b/docs/development.md
@@ -19,7 +19,7 @@ DATABASE_URL=sqlite:///./dev.db REDIS_URL=redis://localhost:6379/0 \
## Frontend dev server
-Node 20 (`.nvmrc`). The Vite dev server proxies `/api` to `localhost:8060` (set `BACKEND_URL` to point it elsewhere),
+Node 24 (`.nvmrc`). The Vite dev server proxies `/api` to `localhost:8060` (set `BACKEND_URL` to point it elsewhere),
matching the production nginx setup.
```bash
@@ -45,7 +45,7 @@ pytest
```
No Docker, PostgreSQL or Redis is needed; the suite takes about two minutes. The chart
-helpers have their own tests that need only Node 20 or newer: `cd src/frontend && node --test`. See
+helpers have their own tests that need only Node 24 or newer: `cd src/frontend && node --test`. See
[TESTS.md](../TESTS.md) for how the tests work, what they don't cover, and what every
test is for.