add nodejs support

Author: paulocoutinhox

.nvmrc

@@ -0,0 +1 @@
+22

README.md

@@ -69,7 +69,7 @@ Whether you need to build a blog, an e-commerce store, a landing page, or any ot
 ## Requirements
 
 - **Python** 3.9+
-- **Node.js** 18+ and **npm** on your `PATH` so the Python build can invoke them (you never run `npm` yourself for normal development or production builds)
+- **Node.js** **20.19+** or **22.12+** (LTS **22** recommended) and **npm** on your `PATH` so the Python build can invoke **Vite 8** (you never run `npm` yourself for normal development or production builds). The repo pins **22** via **`.nvmrc`**, **`netlify.toml`**, **`render.yaml`**, and **`amplify.yml`** where the host reads them.
 
 ## 🚀 How to Get Started
 
@@ -248,9 +248,9 @@ Hosting platforms ship their own Python and Node images. See their current defau
 - **Cloudflare Pages** — [Build image / language support](https://developers.cloudflare.com/pages/configuration/build-image/)
 - **Render** — [Environment](https://render.com/docs/environment) and [native runtimes](https://render.com/docs/native-runtimes)
 
-#### **• Node / npm not found**
+#### **• Node / npm not found or “Vite requires Node.js …”**
 
-If the build fails with **npm was not found in PATH** or similar, install [Node.js](https://nodejs.org/) (LTS). You still only run `python3 kaktos.py` or `python3 kaktos.py build`, and the first run installs `frontend/node_modules` when needed.
+Install [Node.js](https://nodejs.org/) **22 LTS** (or **20.19+**). On hosts that ignore `.nvmrc`, set **`NODE_VERSION=22`** (or equivalent) in the service environment. You still only run `python3 kaktos.py` or `python3 kaktos.py build`; the first run installs `frontend/node_modules` when needed.
 
 #### **• LiveReload did not refresh the browser**
 

amplify.yml

@@ -3,6 +3,9 @@ frontend:
   phases:
     preBuild:
       commands:
+        - nvm install 22
+        - nvm use 22
+        - node -v
         - ln -fs /usr/local/bin/pip3.9 /usr/bin/pip3
         - ln -fs /usr/local/bin/python3.9 /usr/bin/python3
         - python3 -m pip install -r requirements.txt --user

frontend/package.json

@@ -3,6 +3,9 @@
   "version": "1.0.0",
   "private": true,
   "type": "module",
+  "engines": {
+    "node": ">=20.19.0"
+  },
   "scripts": {
     "build": "vite build"
   },

netlify.toml

@@ -1,3 +1,7 @@
 [build]
   command = "python3 kaktos.py build"
   publish = "build"
+
+# Vite 8+: Node 20.19+ or 22.12+ (see also repo root `.nvmrc`, `render.yaml`, `amplify.yml`).
+[build.environment]
+  NODE_VERSION = "22"

render.yaml

@@ -5,5 +5,7 @@ services:
   buildCommand: python3 kaktos.py build
   staticPublishPath: build/
   envVars:
+  - key: NODE_VERSION
+    value: "22"
   - key: PYTHON_VERSION
     value: 3.13.4