From 3ca626463f36478f41325b0fab5476589d5eb896 Mon Sep 17 00:00:00 2001 From: Monibee Fudgekins Date: Sat, 2 May 2026 16:25:27 -0400 Subject: [PATCH 1/2] Clarify Node.js 24 frontend requirement --- docs/development/contributing.md | 2 +- docs/development/local-setup.md | 4 +++- frontend/README.md | 4 ++++ 3 files changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/development/contributing.md b/docs/development/contributing.md index 2a96cac3..c366ad5f 100644 --- a/docs/development/contributing.md +++ b/docs/development/contributing.md @@ -10,7 +10,7 @@ ### Prerequisites - **Rust** 1.80+ with `cargo` -- **Node.js** 20+ with `npm` +- **Node.js** 24+ with `npm` for frontend development. Node.js 20 or older will fail the frontend install/build because `frontend/package.json` requires `>=24.0.0`; upgrade via the [Node.js downloads](https://nodejs.org/en/download) page or a version manager such as [nvm](https://github.com/nvm-sh/nvm). - **PostgreSQL** 16+ - **Redis** 7+ - **S3-compatible storage** (RustFS/MinIO for local dev) diff --git a/docs/development/local-setup.md b/docs/development/local-setup.md index c67e583b..f2c71c51 100644 --- a/docs/development/local-setup.md +++ b/docs/development/local-setup.md @@ -54,9 +54,11 @@ You can run the backend locally while keeping infrastructure services (DB, Redis ### Frontend Development 1. Stop the `frontend` container if running: `docker compose stop frontend` -2. Run npm locally: +2. Use Node.js 24 or newer. Node.js 20 or older will fail the frontend install/build because `frontend/package.json` requires `>=24.0.0`; upgrade via the [Node.js downloads](https://nodejs.org/en/download) page or [nvm](https://github.com/nvm-sh/nvm). +3. Run npm locally: ```bash cd frontend + npm ci npm run dev ``` *Access at [http://localhost:5173](http://localhost:5173).* diff --git a/frontend/README.md b/frontend/README.md index 66f54d89..53f402c9 100644 --- a/frontend/README.md +++ b/frontend/README.md @@ -2,6 +2,10 @@ Vue 3 + TypeScript + Vite SPA for RustChat. +## Requirements + +- Node.js 24+ with `npm`. Node.js 20 or older will fail install/build because this workspace requires `>=24.0.0`; upgrade via the [Node.js downloads](https://nodejs.org/en/download) page or [nvm](https://github.com/nvm-sh/nvm). + ## Commands ```bash From a08d8dc8662b60ea6b2e8776450051e6a17bb190 Mon Sep 17 00:00:00 2001 From: Monibee Fudgekins Date: Sat, 2 May 2026 23:27:39 -0400 Subject: [PATCH 2/2] docs: clarify Node versions below 24 fail --- docs/development/contributing.md | 2 +- docs/development/local-setup.md | 2 +- frontend/README.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/development/contributing.md b/docs/development/contributing.md index c366ad5f..7445933c 100644 --- a/docs/development/contributing.md +++ b/docs/development/contributing.md @@ -10,7 +10,7 @@ ### Prerequisites - **Rust** 1.80+ with `cargo` -- **Node.js** 24+ with `npm` for frontend development. Node.js 20 or older will fail the frontend install/build because `frontend/package.json` requires `>=24.0.0`; upgrade via the [Node.js downloads](https://nodejs.org/en/download) page or a version manager such as [nvm](https://github.com/nvm-sh/nvm). +- **Node.js** 24+ with `npm` for frontend development. Any Node.js version below 24 will fail the frontend install/build because `frontend/package.json` requires `>=24.0.0`; upgrade via the [Node.js downloads](https://nodejs.org/en/download) page or a version manager such as [nvm](https://github.com/nvm-sh/nvm). - **PostgreSQL** 16+ - **Redis** 7+ - **S3-compatible storage** (RustFS/MinIO for local dev) diff --git a/docs/development/local-setup.md b/docs/development/local-setup.md index f2c71c51..dee895be 100644 --- a/docs/development/local-setup.md +++ b/docs/development/local-setup.md @@ -54,7 +54,7 @@ You can run the backend locally while keeping infrastructure services (DB, Redis ### Frontend Development 1. Stop the `frontend` container if running: `docker compose stop frontend` -2. Use Node.js 24 or newer. Node.js 20 or older will fail the frontend install/build because `frontend/package.json` requires `>=24.0.0`; upgrade via the [Node.js downloads](https://nodejs.org/en/download) page or [nvm](https://github.com/nvm-sh/nvm). +2. Use Node.js 24 or newer. Any Node.js version below 24 will fail the frontend install/build because `frontend/package.json` requires `>=24.0.0`; upgrade via the [Node.js downloads](https://nodejs.org/en/download) page or [nvm](https://github.com/nvm-sh/nvm). 3. Run npm locally: ```bash cd frontend diff --git a/frontend/README.md b/frontend/README.md index 53f402c9..96d497aa 100644 --- a/frontend/README.md +++ b/frontend/README.md @@ -4,7 +4,7 @@ Vue 3 + TypeScript + Vite SPA for RustChat. ## Requirements -- Node.js 24+ with `npm`. Node.js 20 or older will fail install/build because this workspace requires `>=24.0.0`; upgrade via the [Node.js downloads](https://nodejs.org/en/download) page or [nvm](https://github.com/nvm-sh/nvm). +- Node.js 24+ with `npm`. Any Node.js version below 24 will fail install/build because this workspace requires `>=24.0.0`; upgrade via the [Node.js downloads](https://nodejs.org/en/download) page or [nvm](https://github.com/nvm-sh/nvm). ## Commands