Limited Wasp version to ^16.0.0 && <=16.15.0 (#634)

* Limited Wasp node version to ^16.0.0 && <=16.15.0. In the process, I removed .nvmrc files from generated code and refactored SemanticVersion to follow npm spec. I also updated CI to use node 16.15.0, and not any 16. I also updated docs.
2024-12-23 17:13:40 +03:00 · 2022-06-17 17:02:54 +02:00 · 2022-06-17 17:02:54 +02:00 · 62f0a76937
commit 62f0a76937
parent fdd8e47b25
39 changed files with 307 additions and 225 deletions
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@ -90,7 +90,7 @@ jobs:
      - name: Set up Node
        uses: actions/setup-node@v2
        with:
-          node-version: '16'
+          node-version: '16.15.0'

      - name: Run tests
        run: cabal test
--- a/waspc/data/Generator/templates/react-app/nvmrc
+++ b/waspc/data/Generator/templates/react-app/nvmrc
@ -1,2 +0,0 @@
-{{={= =}=}}
-{= nodeVersion =}
--- a/waspc/data/Generator/templates/react-app/package.json
+++ b/waspc/data/Generator/templates/react-app/package.json
@ -14,9 +14,10 @@
  "eslintConfig": {
    "extends": "react-app"
  },
+  "engineStrict": true,
  "engines": {
-      "node": "{= nodeVersionBounds =}",
-      "npm": "{= npmVersionBounds =}"
+      "node": "{=& nodeVersionRange =}",
+      "npm": "{=& npmVersionRange =}"
  },
  "browserslist": {
    "production": [
--- a/waspc/data/Generator/templates/server/nvmrc
+++ b/waspc/data/Generator/templates/server/nvmrc
@ -1,2 +0,0 @@
-{{={= =}=}}
-{= nodeVersion =}
--- a/waspc/data/Generator/templates/server/package.json
+++ b/waspc/data/Generator/templates/server/package.json
@ -15,9 +15,10 @@
  "nodemonConfig": {
    "delay": "1000"
  },
+  "engineStrict": true,
  "engines": {
-    "node": "{= nodeVersionBounds =}",
-    "npm": "{= npmVersionBounds =}"
+    "node": "{=& nodeVersionRange =}",
+    "npm": "{=& npmVersionRange =}"
  },
  {=& depsChunk =},
  {=& devDepsChunk =}
--- a/waspc/e2e-test/test-outputs/waspBuild-golden/files.manifest
+++ b/waspc/e2e-test/test-outputs/waspBuild-golden/files.manifest
@ -4,7 +4,6 @@ waspBuild/.wasp/build/Dockerfile
 waspBuild/.wasp/build/db/schema.prisma
 waspBuild/.wasp/build/installedFullStackNpmDependencies.json
 waspBuild/.wasp/build/server/.npmrc
-waspBuild/.wasp/build/server/.nvmrc
 waspBuild/.wasp/build/server/README.md
 waspBuild/.wasp/build/server/package.json
 waspBuild/.wasp/build/server/src/app.js
@ -26,7 +25,6 @@ waspBuild/.wasp/build/server/src/routes/operations/index.js
 waspBuild/.wasp/build/server/src/server.js
 waspBuild/.wasp/build/server/src/utils.js
 waspBuild/.wasp/build/web-app/.npmrc
-waspBuild/.wasp/build/web-app/.nvmrc
 waspBuild/.wasp/build/web-app/README.md
 waspBuild/.wasp/build/web-app/netlify.toml
 waspBuild/.wasp/build/web-app/package.json
--- a/waspc/e2e-test/test-outputs/waspBuild-golden/waspBuild/.wasp/build/.waspchecksums
+++ b/waspc/e2e-test/test-outputs/waspBuild-golden/waspBuild/.wasp/build/.waspchecksums
@ -34,13 +34,6 @@
        ],
        "8a74b1091affea3c71c2cf04acbaa38c4a51a261a9a98dcc9e96473d07a85a27"
    ],
-    [
-        [
-            "file",
-            "server/.nvmrc"
-        ],
-        "e6c21e8d260fe71882debdb339d2402a2ca7648529bc2303f48649bce0380017"
-    ],
    [
        [
            "file",
@ -53,7 +46,7 @@
            "file",
            "server/package.json"
        ],
-        "54d8353286dae688a59458973227cfc1fae57549f49f318ddd46a1abdd716da2"
+        "66df15608f1f501f1eda942061e7b627a82a1033b0d73f8e7d00e430b6906df1"
    ],
    [
        [
@ -195,13 +188,6 @@
        ],
        "7151cf397def0c2cb0ab65643701d27d335a72c90f775675b5f826bc7005818a"
    ],
-    [
-        [
-            "file",
-            "web-app/.nvmrc"
-        ],
-        "e6c21e8d260fe71882debdb339d2402a2ca7648529bc2303f48649bce0380017"
-    ],
    [
        [
            "file",
@ -221,7 +207,7 @@
            "file",
            "web-app/package.json"
        ],
-        "1c8677831516081acee6696e3553d36b887332ccfeaad6c84fa758dcba88031e"
+        "3b3724d8f44d2a7652b6426f7e1e494031df868d23a29850afa260e67ff8da72"
    ],
    [
        [
--- a/waspc/e2e-test/test-outputs/waspBuild-golden/waspBuild/.wasp/build/server/.nvmrc
+++ b/waspc/e2e-test/test-outputs/waspBuild-golden/waspBuild/.wasp/build/server/.nvmrc
@ -1 +0,0 @@
-16
--- a/waspc/e2e-test/test-outputs/waspBuild-golden/waspBuild/.wasp/build/server/package.json
+++ b/waspc/e2e-test/test-outputs/waspBuild-golden/waspBuild/.wasp/build/server/package.json
@ -16,9 +16,10 @@
    "prisma": "3.9.1",
    "standard": "^14.3.4"
  },
+  "engineStrict": true,
  "engines": {
-    "node": "^16.0.0",
-    "npm": "^8.0.0"
+    "node": "^16.0.0 <=16.15.0",
+    "npm": "^8.0.0 <=8.5.5"
  },
  "name": "server",
  "nodemonConfig": {
--- a/waspc/e2e-test/test-outputs/waspBuild-golden/waspBuild/.wasp/build/web-app/.nvmrc
+++ b/waspc/e2e-test/test-outputs/waspBuild-golden/waspBuild/.wasp/build/web-app/.nvmrc
@ -1 +0,0 @@
-16
--- a/waspc/e2e-test/test-outputs/waspBuild-golden/waspBuild/.wasp/build/web-app/package.json
+++ b/waspc/e2e-test/test-outputs/waspBuild-golden/waspBuild/.wasp/build/web-app/package.json
@ -23,9 +23,10 @@
    "uuid": "^3.4.0"
  },
  "devDependencies": {},
+  "engineStrict": true,
  "engines": {
-    "node": "^16.0.0",
-    "npm": "^8.0.0"
+    "node": "^16.0.0 <=16.15.0",
+    "npm": "^8.0.0 <=8.5.5"
  },
  "eslintConfig": {
    "extends": "react-app"
--- a/waspc/e2e-test/test-outputs/waspCompile-golden/files.manifest
+++ b/waspc/e2e-test/test-outputs/waspCompile-golden/files.manifest
@ -4,7 +4,6 @@ waspCompile/.wasp/out/Dockerfile
 waspCompile/.wasp/out/db/schema.prisma
 waspCompile/.wasp/out/installedFullStackNpmDependencies.json
 waspCompile/.wasp/out/server/.npmrc
-waspCompile/.wasp/out/server/.nvmrc
 waspCompile/.wasp/out/server/README.md
 waspCompile/.wasp/out/server/package.json
 waspCompile/.wasp/out/server/src/app.js
@ -26,7 +25,6 @@ waspCompile/.wasp/out/server/src/routes/operations/index.js
 waspCompile/.wasp/out/server/src/server.js
 waspCompile/.wasp/out/server/src/utils.js
 waspCompile/.wasp/out/web-app/.npmrc
-waspCompile/.wasp/out/web-app/.nvmrc
 waspCompile/.wasp/out/web-app/README.md
 waspCompile/.wasp/out/web-app/netlify.toml
 waspCompile/.wasp/out/web-app/package.json
--- a/waspc/e2e-test/test-outputs/waspCompile-golden/waspCompile/.wasp/out/.waspchecksums
+++ b/waspc/e2e-test/test-outputs/waspCompile-golden/waspCompile/.wasp/out/.waspchecksums
@ -34,13 +34,6 @@
        ],
        "8a74b1091affea3c71c2cf04acbaa38c4a51a261a9a98dcc9e96473d07a85a27"
    ],
-    [
-        [
-            "file",
-            "server/.nvmrc"
-        ],
-        "e6c21e8d260fe71882debdb339d2402a2ca7648529bc2303f48649bce0380017"
-    ],
    [
        [
            "file",
@ -53,7 +46,7 @@
            "file",
            "server/package.json"
        ],
-        "54d8353286dae688a59458973227cfc1fae57549f49f318ddd46a1abdd716da2"
+        "66df15608f1f501f1eda942061e7b627a82a1033b0d73f8e7d00e430b6906df1"
    ],
    [
        [
@ -195,13 +188,6 @@
        ],
        "7151cf397def0c2cb0ab65643701d27d335a72c90f775675b5f826bc7005818a"
    ],
-    [
-        [
-            "file",
-            "web-app/.nvmrc"
-        ],
-        "e6c21e8d260fe71882debdb339d2402a2ca7648529bc2303f48649bce0380017"
-    ],
    [
        [
            "file",
@ -221,7 +207,7 @@
            "file",
            "web-app/package.json"
        ],
-        "386f6add035afddc94aacd930bd52a1b184cb41063ece66c5a83aba3ef1246d9"
+        "8351f0d9a0eb46ffc9b222567e1bcf89b68f59cec062caaaac0a71ff6f001b26"
    ],
    [
        [
--- a/waspc/e2e-test/test-outputs/waspCompile-golden/waspCompile/.wasp/out/server/.nvmrc
+++ b/waspc/e2e-test/test-outputs/waspCompile-golden/waspCompile/.wasp/out/server/.nvmrc
@ -1 +0,0 @@
-16
--- a/waspc/e2e-test/test-outputs/waspCompile-golden/waspCompile/.wasp/out/server/package.json
+++ b/waspc/e2e-test/test-outputs/waspCompile-golden/waspCompile/.wasp/out/server/package.json
@ -16,9 +16,10 @@
    "prisma": "3.9.1",
    "standard": "^14.3.4"
  },
+  "engineStrict": true,
  "engines": {
-    "node": "^16.0.0",
-    "npm": "^8.0.0"
+    "node": "^16.0.0 <=16.15.0",
+    "npm": "^8.0.0 <=8.5.5"
  },
  "name": "server",
  "nodemonConfig": {
--- a/waspc/e2e-test/test-outputs/waspCompile-golden/waspCompile/.wasp/out/web-app/.nvmrc
+++ b/waspc/e2e-test/test-outputs/waspCompile-golden/waspCompile/.wasp/out/web-app/.nvmrc
@ -1 +0,0 @@
-16
--- a/waspc/e2e-test/test-outputs/waspCompile-golden/waspCompile/.wasp/out/web-app/package.json
+++ b/waspc/e2e-test/test-outputs/waspCompile-golden/waspCompile/.wasp/out/web-app/package.json
@ -23,9 +23,10 @@
    "uuid": "^3.4.0"
  },
  "devDependencies": {},
+  "engineStrict": true,
  "engines": {
-    "node": "^16.0.0",
-    "npm": "^8.0.0"
+    "node": "^16.0.0 <=16.15.0",
+    "npm": "^8.0.0 <=8.5.5"
  },
  "eslintConfig": {
    "extends": "react-app"
--- a/waspc/e2e-test/test-outputs/waspJob-golden/files.manifest
+++ b/waspc/e2e-test/test-outputs/waspJob-golden/files.manifest
@ -4,7 +4,6 @@ waspJob/.wasp/out/Dockerfile
 waspJob/.wasp/out/db/schema.prisma
 waspJob/.wasp/out/installedFullStackNpmDependencies.json
 waspJob/.wasp/out/server/.npmrc
-waspJob/.wasp/out/server/.nvmrc
 waspJob/.wasp/out/server/README.md
 waspJob/.wasp/out/server/package.json
 waspJob/.wasp/out/server/src/app.js
@ -28,7 +27,6 @@ waspJob/.wasp/out/server/src/routes/operations/index.js
 waspJob/.wasp/out/server/src/server.js
 waspJob/.wasp/out/server/src/utils.js
 waspJob/.wasp/out/web-app/.npmrc
-waspJob/.wasp/out/web-app/.nvmrc
 waspJob/.wasp/out/web-app/README.md
 waspJob/.wasp/out/web-app/netlify.toml
 waspJob/.wasp/out/web-app/package.json
--- a/waspc/e2e-test/test-outputs/waspJob-golden/waspJob/.wasp/out/.waspchecksums
+++ b/waspc/e2e-test/test-outputs/waspJob-golden/waspJob/.wasp/out/.waspchecksums
@ -34,13 +34,6 @@
        ],
        "8a74b1091affea3c71c2cf04acbaa38c4a51a261a9a98dcc9e96473d07a85a27"
    ],
-    [
-        [
-            "file",
-            "server/.nvmrc"
-        ],
-        "e6c21e8d260fe71882debdb339d2402a2ca7648529bc2303f48649bce0380017"
-    ],
    [
        [
            "file",
@ -53,7 +46,7 @@
            "file",
            "server/package.json"
        ],
-        "ed4cedc6f1595457dbcf57380909f11e789d5b86af900009dbc1cfe6afa2bb04"
+        "af2ab353120775cc7d4e9ff61c853994c4e02e761e942fae06b70cee58651020"
    ],
    [
        [
@ -209,13 +202,6 @@
        ],
        "7151cf397def0c2cb0ab65643701d27d335a72c90f775675b5f826bc7005818a"
    ],
-    [
-        [
-            "file",
-            "web-app/.nvmrc"
-        ],
-        "e6c21e8d260fe71882debdb339d2402a2ca7648529bc2303f48649bce0380017"
-    ],
    [
        [
            "file",
@ -235,7 +221,7 @@
            "file",
            "web-app/package.json"
        ],
-        "67e7b3c15c7f0316d4988c50e0d03d3103759b369662ceca6cdc6217fe2b5632"
+        "b6e6aef85445808b54fa8cd9b5ac7b85105eeb2d55dc002fe20f374f06212c66"
    ],
    [
        [
--- a/waspc/e2e-test/test-outputs/waspJob-golden/waspJob/.wasp/out/server/.nvmrc
+++ b/waspc/e2e-test/test-outputs/waspJob-golden/waspJob/.wasp/out/server/.nvmrc
@ -1 +0,0 @@
-16
--- a/waspc/e2e-test/test-outputs/waspJob-golden/waspJob/.wasp/out/server/package.json
+++ b/waspc/e2e-test/test-outputs/waspJob-golden/waspJob/.wasp/out/server/package.json
@ -17,9 +17,10 @@
    "prisma": "3.9.1",
    "standard": "^14.3.4"
  },
+  "engineStrict": true,
  "engines": {
-    "node": "^16.0.0",
-    "npm": "^8.0.0"
+    "node": "^16.0.0 <=16.15.0",
+    "npm": "^8.0.0 <=8.5.5"
  },
  "name": "server",
  "nodemonConfig": {
--- a/waspc/e2e-test/test-outputs/waspJob-golden/waspJob/.wasp/out/web-app/.nvmrc
+++ b/waspc/e2e-test/test-outputs/waspJob-golden/waspJob/.wasp/out/web-app/.nvmrc
@ -1 +0,0 @@
-16
--- a/waspc/e2e-test/test-outputs/waspJob-golden/waspJob/.wasp/out/web-app/package.json
+++ b/waspc/e2e-test/test-outputs/waspJob-golden/waspJob/.wasp/out/web-app/package.json
@ -23,9 +23,10 @@
    "uuid": "^3.4.0"
  },
  "devDependencies": {},
+  "engineStrict": true,
  "engines": {
-    "node": "^16.0.0",
-    "npm": "^8.0.0"
+    "node": "^16.0.0 <=16.15.0",
+    "npm": "^8.0.0 <=8.5.5"
  },
  "eslintConfig": {
    "extends": "react-app"
--- a/waspc/e2e-test/test-outputs/waspMigrate-golden/files.manifest
+++ b/waspc/e2e-test/test-outputs/waspMigrate-golden/files.manifest
@ -9,7 +9,6 @@ waspMigrate/.wasp/out/db/schema.prisma.wasp-generate-checksum
 waspMigrate/.wasp/out/db/schema.prisma.wasp-migrate-checksum
 waspMigrate/.wasp/out/installedFullStackNpmDependencies.json
 waspMigrate/.wasp/out/server/.npmrc
-waspMigrate/.wasp/out/server/.nvmrc
 waspMigrate/.wasp/out/server/README.md
 waspMigrate/.wasp/out/server/package.json
 waspMigrate/.wasp/out/server/src/app.js
@ -31,7 +30,6 @@ waspMigrate/.wasp/out/server/src/routes/operations/index.js
 waspMigrate/.wasp/out/server/src/server.js
 waspMigrate/.wasp/out/server/src/utils.js
 waspMigrate/.wasp/out/web-app/.npmrc
-waspMigrate/.wasp/out/web-app/.nvmrc
 waspMigrate/.wasp/out/web-app/README.md
 waspMigrate/.wasp/out/web-app/netlify.toml
 waspMigrate/.wasp/out/web-app/package.json
--- a/waspc/e2e-test/test-outputs/waspMigrate-golden/waspMigrate/.wasp/out/.waspchecksums
+++ b/waspc/e2e-test/test-outputs/waspMigrate-golden/waspMigrate/.wasp/out/.waspchecksums
@ -34,13 +34,6 @@
        ],
        "8a74b1091affea3c71c2cf04acbaa38c4a51a261a9a98dcc9e96473d07a85a27"
    ],
-    [
-        [
-            "file",
-            "server/.nvmrc"
-        ],
-        "e6c21e8d260fe71882debdb339d2402a2ca7648529bc2303f48649bce0380017"
-    ],
    [
        [
            "file",
@ -53,7 +46,7 @@
            "file",
            "server/package.json"
        ],
-        "8d4dae59b2eeae186ef18098d546e6850a3702b9c7c0c059fb20b3f6e1d8a113"
+        "d75927e049f63a022dc0740641115b5841a393031899b2b84d1d0c43ecf2388a"
    ],
    [
        [
@ -195,13 +188,6 @@
        ],
        "7151cf397def0c2cb0ab65643701d27d335a72c90f775675b5f826bc7005818a"
    ],
-    [
-        [
-            "file",
-            "web-app/.nvmrc"
-        ],
-        "e6c21e8d260fe71882debdb339d2402a2ca7648529bc2303f48649bce0380017"
-    ],
    [
        [
            "file",
@ -221,7 +207,7 @@
            "file",
            "web-app/package.json"
        ],
-        "b8135251bd0b41b4e0460a700d21d0433ef4690b8bda65f919967532f4fd43f4"
+        "581f025e9f75fdca5ec2b11b1f2b7981142ea8ebb9662e61b535276eba6ae149"
    ],
    [
        [
--- a/waspc/e2e-test/test-outputs/waspMigrate-golden/waspMigrate/.wasp/out/server/.nvmrc
+++ b/waspc/e2e-test/test-outputs/waspMigrate-golden/waspMigrate/.wasp/out/server/.nvmrc
@ -1 +0,0 @@
-16
--- a/waspc/e2e-test/test-outputs/waspMigrate-golden/waspMigrate/.wasp/out/server/package.json
+++ b/waspc/e2e-test/test-outputs/waspMigrate-golden/waspMigrate/.wasp/out/server/package.json
@ -16,9 +16,10 @@
    "prisma": "3.9.1",
    "standard": "^14.3.4"
  },
+  "engineStrict": true,
  "engines": {
-    "node": "^16.0.0",
-    "npm": "^8.0.0"
+    "node": "^16.0.0 <=16.15.0",
+    "npm": "^8.0.0 <=8.5.5"
  },
  "name": "server",
  "nodemonConfig": {
--- a/waspc/e2e-test/test-outputs/waspMigrate-golden/waspMigrate/.wasp/out/web-app/.nvmrc
+++ b/waspc/e2e-test/test-outputs/waspMigrate-golden/waspMigrate/.wasp/out/web-app/.nvmrc
@ -1 +0,0 @@
-16
--- a/waspc/e2e-test/test-outputs/waspMigrate-golden/waspMigrate/.wasp/out/web-app/package.json
+++ b/waspc/e2e-test/test-outputs/waspMigrate-golden/waspMigrate/.wasp/out/web-app/package.json
@ -23,9 +23,10 @@
    "uuid": "^3.4.0"
  },
  "devDependencies": {},
+  "engineStrict": true,
  "engines": {
-    "node": "^16.0.0",
-    "npm": "^8.0.0"
+    "node": "^16.0.0 <=16.15.0",
+    "npm": "^8.0.0 <=8.5.5"
  },
  "eslintConfig": {
    "extends": "react-app"
--- a/waspc/src/Wasp/Generator/Common.hs
+++ b/waspc/src/Wasp/Generator/Common.hs
@ -1,9 +1,8 @@
 module Wasp.Generator.Common
  ( ProjectRootDir,
-    nodeVersion,
-    nodeVersionBounds,
-    npmVersionBounds,
-    prismaVersionBounds,
+    nodeVersionRange,
+    npmVersionRange,
+    prismaVersion,
  )
 where

@ -12,21 +11,30 @@ import qualified Wasp.SemanticVersion as SV
 -- | Directory where the whole web app project (client, server, ...) is generated.
 data ProjectRootDir

-- | Node version that node packages generated by this generator expect.
-nodeVersion :: SV.Version
-nodeVersion = SV.Version 16 0 0 -- Latest LTS version.
+-- | Range of node versions that node packages generated by this generator work correctly with.
+nodeVersionRange :: SV.Range
+nodeVersionRange =
+  SV.rangeFromVersionsIntersection
+    [ (SV.BackwardsCompatibleWith, latestLTSVersion),
+      (SV.LessThanOrEqual, latestLTSExactVersionThatWeKnowWorks)
+    ]
+  where
+    latestLTSVersion = SV.Version 16 0 0
+    -- There is a bug in node 16.15.1 (more correctly, in npm 8.11.0 that comes with it)
+    -- that messes up how Wasp uses Prisma. That is why we limited ourselves to <=16.15.0 for now.
+    -- Bug issue on NPM CLI repo: https://github.com/npm/cli/issues/5018 .
+    latestLTSExactVersionThatWeKnowWorks = SV.Version 16 15 0

-nodeVersionBounds :: SV.VersionBounds
-nodeVersionBounds = SV.BackwardsCompatibleWith nodeVersion
-
-npmVersion :: SV.Version
-npmVersion = SV.Version 8 0 0 -- Latest LTS version.
-
-npmVersionBounds :: SV.VersionBounds
-npmVersionBounds = SV.BackwardsCompatibleWith npmVersion
+-- | Range of npm versions that Wasp and generated projects work correctly with.
+npmVersionRange :: SV.Range
+npmVersionRange =
+  SV.rangeFromVersionsIntersection
+    [ (SV.BackwardsCompatibleWith, latestLTSVersion),
+      (SV.LessThanOrEqual, latestLTSExactVersionThatWeKnowWorks)
+    ]
+  where
+    latestLTSVersion = SV.Version 8 0 0 -- Goes with node 16
+    latestLTSExactVersionThatWeKnowWorks = SV.Version 8 5 5 -- Goes with node 16.15.0

 prismaVersion :: SV.Version
 prismaVersion = SV.Version 3 9 1
-
-prismaVersionBounds :: SV.VersionBounds
-prismaVersionBounds = SV.Exact prismaVersion
--- a/waspc/src/Wasp/Generator/DbGenerator/Jobs.hs
+++ b/waspc/src/Wasp/Generator/DbGenerator/Jobs.hs
@ -11,7 +11,7 @@ import StrongPath (Abs, Dir, Path', (</>))
 import qualified StrongPath as SP
 import System.Exit (ExitCode (..))
 import qualified System.Info
-import Wasp.Generator.Common (ProjectRootDir, prismaVersionBounds)
+import Wasp.Generator.Common (ProjectRootDir, prismaVersion)
 import Wasp.Generator.DbGenerator.Common (dbSchemaFileInProjectRootDir)
 import Wasp.Generator.Job (JobMessage, JobMessageData (JobExit, JobOutput))
 import qualified Wasp.Generator.Job as J
@ -24,7 +24,7 @@ import Wasp.Generator.ServerGenerator.Common (serverRootDirInProjectRootDir)
 -- We also pin the version to what we need so it won't accidentally find a different version globally
 --   somewhere on the PATH.
 npxPrismaCmd :: [String]
-npxPrismaCmd = ["npx", "--no-install", "prisma@" ++ show prismaVersionBounds]
+npxPrismaCmd = ["npx", "--no-install", "prisma@" ++ show prismaVersion]

 migrateDev :: Path' Abs (Dir ProjectRootDir) -> Maybe String -> J.Job
 migrateDev projectDir maybeMigrationName = do
--- a/waspc/src/Wasp/Generator/Job/Process.hs
+++ b/waspc/src/Wasp/Generator/Job/Process.hs
@ -100,7 +100,7 @@ runNodeCommandAsJob fromDir command args jobType chan = do
  case errorOrNodeVersion of
    Left errorMsg -> exitWithError (ExitFailure 1) (T.pack errorMsg)
    Right nodeVersion ->
-      if SV.isVersionInBounds nodeVersion C.nodeVersionBounds
+      if SV.isVersionInRange nodeVersion C.nodeVersionRange
        then do
          let process = (P.proc command args) {P.cwd = Just $ SP.fromAbsDir fromDir}
          runProcessAsJob process jobType chan
@ -167,6 +167,6 @@ makeNodeVersionMismatchMessage nodeVersion =
 waspNodeRequirementMessage :: String
 waspNodeRequirementMessage =
  unwords
-    [ "Wasp requires node " ++ show C.nodeVersionBounds ++ ".",
+    [ "Wasp requires node " ++ show C.nodeVersionRange ++ ".",
      "Check Wasp docs for more details: https://wasp-lang.dev/docs#requirements."
    ]
--- a/waspc/src/Wasp/Generator/ServerGenerator.hs
+++ b/waspc/src/Wasp/Generator/ServerGenerator.hs
@ -34,7 +34,7 @@ import qualified Wasp.AppSpec.App.Server as AS.App.Server
 import qualified Wasp.AppSpec.Entity as AS.Entity
 import Wasp.AppSpec.Util (isPgBossJobExecutorUsed)
 import Wasp.AppSpec.Valid (getApp, isAuthEnabled)
-import Wasp.Generator.Common (nodeVersion, nodeVersionBounds, npmVersionBounds, prismaVersionBounds)
+import Wasp.Generator.Common (nodeVersionRange, npmVersionRange, prismaVersion)
 import Wasp.Generator.ExternalCodeGenerator (genExternalCodeDir)
 import Wasp.Generator.ExternalCodeGenerator.Common (GeneratedExternalCodeDir)
 import Wasp.Generator.FileDraft (FileDraft, createCopyFileDraft)
@ -48,7 +48,6 @@ import qualified Wasp.Generator.ServerGenerator.ExternalCodeGenerator as ServerE
 import Wasp.Generator.ServerGenerator.JobGenerator (depsRequiredByJobs, genJobExecutors, genJobs)
 import Wasp.Generator.ServerGenerator.OperationsG (genOperations)
 import Wasp.Generator.ServerGenerator.OperationsRoutesG (genOperationsRoutes)
-import qualified Wasp.SemanticVersion as SV
 import Wasp.Util ((<++>))

 genServer :: AppSpec -> Generator [FileDraft]
@ -57,7 +56,6 @@ genServer spec =
    [ genReadme,
      genPackageJson spec (npmDepsForWasp spec),
      genNpmrc,
-      genNvmrc,
      genGitignore
    ]
    <++> genSrcDir spec
@ -94,8 +92,8 @@ genPackageJson spec waspDependencies = do
          object
            [ "depsChunk" .= N.getDependenciesPackageJsonEntry combinedDependencies,
              "devDepsChunk" .= N.getDevDependenciesPackageJsonEntry combinedDependencies,
-              "nodeVersionBounds" .= show nodeVersionBounds,
-              "npmVersionBounds" .= show npmVersionBounds,
+              "nodeVersionRange" .= show nodeVersionRange,
+              "npmVersionRange" .= show npmVersionRange,
              "startProductionScript"
                .= ( (if not (null $ AS.getDecls @AS.Entity.Entity spec) then "npm run db-migrate-prod && " else "")
                       ++ "NODE_ENV=production node ./src/server.js"
@ -113,7 +111,7 @@ npmDepsForWasp spec =
            ("debug", "~2.6.9"),
            ("express", "~4.16.1"),
            ("morgan", "~1.9.1"),
-            ("@prisma/client", show prismaVersionBounds),
+            ("@prisma/client", show prismaVersion),
            ("jsonwebtoken", "^8.5.1"),
            ("secure-password", "^4.0.0"),
            ("dotenv", "8.2.0"),
@ -124,7 +122,7 @@ npmDepsForWasp spec =
        AS.Dependency.fromList
          [ ("nodemon", "^2.0.4"),
            ("standard", "^14.3.4"),
-            ("prisma", show prismaVersionBounds)
+            ("prisma", show prismaVersion)
          ]
    }

@ -136,19 +134,6 @@ genNpmrc =
      (C.asServerFile [relfile|.npmrc|])
      Nothing

-genNvmrc :: Generator FileDraft
-genNvmrc =
-  return $
-    C.mkTmplFdWithDstAndData
-      (C.asTmplFile [relfile|nvmrc|])
-      (C.asServerFile [relfile|.nvmrc|])
-      -- We want to specify only the major version here. If we specified the
-      -- entire version string (i.e., 16.0.0), our project would work only with
-      -- that exact version, which we don't want. Unfortunately, the nvmrc file
-      -- format doesn't allow semver compatibility strings (e.g., ^16.0.0) so
-      -- listing the major version was the next best thing.
-      (Just (object ["nodeVersion" .= show (SV.major nodeVersion)]))
-
 genGitignore :: Generator FileDraft
 genGitignore =
  return $
--- a/waspc/src/Wasp/Generator/ServerGenerator/JobGenerator.hs
+++ b/waspc/src/Wasp/Generator/ServerGenerator/JobGenerator.hs
@ -1,7 +1,7 @@
 module Wasp.Generator.ServerGenerator.JobGenerator
  ( genJobs,
    genJobExecutors,
-    pgBossVersionBounds,
+    pgBossVersionRange,
    pgBossDependency,
    depsRequiredByJobs,
  )
@ -136,11 +136,11 @@ jobsDirInServerRootDir = SP.castRel jobsDirInServerTemplatesDir

 -- NOTE: Our pg-boss related documentation references this version in URLs.
 -- Please update the docs when this changes (until we solve: https://github.com/wasp-lang/wasp/issues/596).
-pgBossVersionBounds :: SV.VersionBounds
-pgBossVersionBounds = SV.BackwardsCompatibleWith (SV.Version 7 2 1)
+pgBossVersionRange :: SV.Range
+pgBossVersionRange = SV.rangeFromVersion (SV.BackwardsCompatibleWith, SV.Version 7 2 1)

 pgBossDependency :: AS.Dependency.Dependency
-pgBossDependency = AS.Dependency.make ("pg-boss", show pgBossVersionBounds)
+pgBossDependency = AS.Dependency.make ("pg-boss", show pgBossVersionRange)

 depsRequiredByJobs :: AppSpec -> [AS.Dependency.Dependency]
 depsRequiredByJobs spec = [pgBossDependency | isPgBossJobExecutorUsed spec]
--- a/waspc/src/Wasp/Generator/WebAppGenerator.hs
+++ b/waspc/src/Wasp/Generator/WebAppGenerator.hs
@ -23,7 +23,7 @@ import qualified Wasp.AppSpec.App as AS.App
 import Wasp.AppSpec.App.Client as AS.App.Client
 import qualified Wasp.AppSpec.App.Dependency as AS.Dependency
 import Wasp.AppSpec.Valid (getApp)
-import Wasp.Generator.Common (nodeVersion, nodeVersionBounds, npmVersionBounds)
+import Wasp.Generator.Common (nodeVersionRange, npmVersionRange)
 import Wasp.Generator.ExternalCodeGenerator (genExternalCodeDir)
 import Wasp.Generator.ExternalCodeGenerator.Common (GeneratedExternalCodeDir)
 import Wasp.Generator.FileDraft
@ -35,7 +35,6 @@ import qualified Wasp.Generator.WebAppGenerator.Common as C
 import qualified Wasp.Generator.WebAppGenerator.ExternalCodeGenerator as WebAppExternalCodeGenerator
 import Wasp.Generator.WebAppGenerator.OperationsGenerator (genOperations)
 import Wasp.Generator.WebAppGenerator.RouterGenerator (genRouter)
-import qualified Wasp.SemanticVersion as SV
 import Wasp.Util ((<++>))

 genWebApp :: AppSpec -> Generator [FileDraft]
@ -44,7 +43,6 @@ genWebApp spec = do
    [ genReadme,
      genPackageJson spec (npmDepsForWasp spec),
      genNpmrc,
-      genNvmrc,
      genGitignore,
      return $ C.mkTmplFd $ C.asTmplFile [relfile|netlify.toml|]
    ]
@ -67,8 +65,8 @@ genPackageJson spec waspDependencies = do
            [ "appName" .= (fst (getApp spec) :: String),
              "depsChunk" .= N.getDependenciesPackageJsonEntry combinedDependencies,
              "devDepsChunk" .= N.getDevDependenciesPackageJsonEntry combinedDependencies,
-              "nodeVersionBounds" .= show nodeVersionBounds,
-              "npmVersionBounds" .= show npmVersionBounds
+              "nodeVersionRange" .= show nodeVersionRange,
+              "npmVersionRange" .= show npmVersionRange
            ]
      )

@ -80,15 +78,6 @@ genNpmrc =
      (C.asWebAppFile [relfile|.npmrc|])
      Nothing

-genNvmrc :: Generator FileDraft
-genNvmrc =
-  return $
-    C.mkTmplFdWithDstAndData
-      (C.asTmplFile [relfile|nvmrc|])
-      (C.asWebAppFile [relfile|.nvmrc|])
-      -- We want to specify only the major version, check the comment in `ServerGenerator.hs` for details
-      (Just (object ["nodeVersion" .= show (SV.major nodeVersion)]))
-
 npmDepsForWasp :: AppSpec -> N.NpmDepsForWasp
 npmDepsForWasp _spec =
  N.NpmDepsForWasp
--- a/waspc/src/Wasp/SemanticVersion.hs
+++ b/waspc/src/Wasp/SemanticVersion.hs
@ -1,13 +1,23 @@
 module Wasp.SemanticVersion
  ( Version (..),
-    VersionBounds (..),
-    isVersionInBounds,
+    Operator (..),
+    Comparator (..),
+    ComparatorSet (..),
+    Range (..),
+    isVersionInRange,
+    rangeFromVersion,
+    rangeFromVersionsIntersection,
  )
 where

+import Data.List (intercalate)
+import Data.List.NonEmpty (NonEmpty)
+import qualified Data.List.NonEmpty as NE
 import Numeric.Natural
 import Text.Printf (printf)

+-- Implements SemVer (semantic versioning) by following spec from https://github.com/npm/node-semver .
+
 data Version = Version
  { major :: Natural,
    minor :: Natural,
@ -15,27 +25,80 @@ data Version = Version
  }
  deriving (Eq, Ord)

+-- | We rely on `show` here to produce valid semver representation of version.
 instance Show Version where
  show (Version mjr mnr ptc) = printf "%d.%d.%d" mjr mnr ptc

-data VersionBounds
-  = -- | Allows only the version exactly equal to the one specified in the bounds
-    Exact Version
-  | -- | Allows changes that do not modify the leftmost non-zero digit in major.minor.patch, as described
-    -- in node semver docs: https://github.com/npm/node-semver#caret-ranges-123-025-004
-    BackwardsCompatibleWith Version
+data Operator
+  = Equal
+  | LessThanOrEqual
+  | -- | TODO: BackwardsCompatibleWith (^) is actually, by semver spec, a special "range" which desugarizes into basic
+    -- comparators.
+    -- Same goes for other special ranges like Hyphen, v.x.x, ~, ... . They are all sugars that can be expressed with basic
+    -- comparators.
+    -- Although they call them special "ranges", since they all desugarize into comparator sets (no ||), we can also
+    -- more strictly treat them as special "comparator sets".
+    -- Therefore, we should remove ^ as an operator from here and instead extend ComparatorSet as:
+    -- data ComparatorSet = Regular (NonEmpty Comparator) | Special ComparatorSetSpecial
+    -- data ComparatorSetSpecial = BackwardsCompatibleWith Version | Hyphen Version Version | ...
+    BackwardsCompatibleWith
+  deriving (Eq)

-instance Show VersionBounds where
-  show (BackwardsCompatibleWith version) = "^" ++ show version
-  show (Exact version) = show version
+-- | We rely on `show` here to produce valid semver representation of operator.
+instance Show Operator where
+  show Equal = "="
+  show LessThanOrEqual = "<="
+  show BackwardsCompatibleWith = "^"

-isVersionInBounds :: Version -> VersionBounds -> Bool
-isVersionInBounds version bounds = case bounds of
-  (BackwardsCompatibleWith reference) -> version >= reference && version < nextBreakingChangeVersion reference
-  (Exact reference) -> version == reference
+data Comparator = Comparator Operator Version
+  deriving (Eq)
+
+-- | We rely on `show` here to produce valid semver representation of comparator.
+instance Show Comparator where
+  show (Comparator op v) = show op ++ show v
+
+data ComparatorSet = ComparatorSet (NonEmpty Comparator)
+  deriving (Eq)
+
+-- | We rely on `show` here to produce valid semver representation of comparator set.
+instance Show ComparatorSet where
+  show (ComparatorSet comps) = unwords $ show <$> NE.toList comps
+
+data Range = Range [ComparatorSet]
+  deriving (Eq)
+
+-- | We rely on `show` here to produce valid semver representation of version range.
+instance Show Range where
+  show (Range compSets) = intercalate " || " $ show <$> compSets
+
+-- | We define concatenation of two version ranges as union of their comparator sets.
+instance Semigroup Range where
+  (Range csets1) <> (Range csets2) = Range $ csets1 <> csets2
+
+instance Monoid Range where
+  mempty = Range []

 nextBreakingChangeVersion :: Version -> Version
 nextBreakingChangeVersion version = case version of
  (Version 0 0 x) -> Version 0 0 (succ x)
  (Version 0 x _) -> Version 0 (succ x) 0
  (Version x _ _) -> Version (succ x) 0 0
+
+doesVersionSatisfyComparator :: Version -> Comparator -> Bool
+doesVersionSatisfyComparator version (Comparator operator compVersion) = case operator of
+  Equal -> version == compVersion
+  LessThanOrEqual -> version <= compVersion
+  BackwardsCompatibleWith -> version >= compVersion && version < nextBreakingChangeVersion compVersion
+
+doesVersionSatisfyComparatorSet :: Version -> ComparatorSet -> Bool
+doesVersionSatisfyComparatorSet version (ComparatorSet comps) = all (doesVersionSatisfyComparator version) comps
+
+isVersionInRange :: Version -> Range -> Bool
+isVersionInRange version (Range compSets) = any (doesVersionSatisfyComparatorSet version) compSets
+
+rangeFromVersion :: (Operator, Version) -> Range
+rangeFromVersion = Range . pure . ComparatorSet . pure . uncurry Comparator
+
+rangeFromVersionsIntersection :: [(Operator, Version)] -> Range
+rangeFromVersionsIntersection [] = Range []
+rangeFromVersionsIntersection compPairs = Range $ pure $ ComparatorSet $ uncurry Comparator <$> NE.fromList compPairs
--- a/waspc/test/SemanticVersionTest.hs
+++ b/waspc/test/SemanticVersionTest.hs
@ -1,39 +1,133 @@
 module SemanticVersionTest where

+import Data.List.NonEmpty (fromList)
+import Numeric.Natural
 import Test.Tasty.Hspec
 import Wasp.SemanticVersion

-spec_isVersionInBounds :: Spec
-spec_isVersionInBounds = do
-  it "Correctly determines satisfied exact version bounds" $
-    Version 1 2 3 `isVersionInBounds` Exact (Version 1 2 3)
-  it "Correctly determines unsatisfied exact version bounds" $
-    not $
-      any
-        (`isVersionInBounds` Exact (Version 1 2 3))
-        [Version 2 2 3, Version 1 3 3, Version 1 2 4]
-  it "Correctly determine satisfied backwards compatible version bounds" $
-    all
-      (`isVersionInBounds` BackwardsCompatibleWith (Version 1 2 3))
-      [Version 1 2 3, Version 1 2 4, Version 1 3 0]
-  it "Correctly determines unsatisfied backwards compatible version bounds" $
-    not $
-      any
-        (`isVersionInBounds` BackwardsCompatibleWith (Version 1 2 3))
-        [Version 1 2 0, Version 1 2 2, Version 2 0 0]
-  it "Correctly determines satisfied backwards compatible version bounds with 0.x versions" $
-    all
-      (`isVersionInBounds` BackwardsCompatibleWith (Version 0 2 3))
-      [Version 0 2 3, Version 0 2 4]
-  it "Correctly determines unsatisfied backwards compatible version bounds with 0.x versions" $
-    not $
-      any
-        (`isVersionInBounds` BackwardsCompatibleWith (Version 0 2 3))
-        [Version 0 0 0, Version 0 1 3, Version 0 2 0, Version 0 2 2, Version 0 3 0, Version 1 0 0]
-  it "Correctly determines satisfied backwards compatible version bounds with 0.0.x versions" $
-    Version 0 0 2 `isVersionInBounds` BackwardsCompatibleWith (Version 0 0 2)
-  it "Correctly determines unsatisfied backwards compatible version bounds with 0.0.x versions" $
-    not $
-      any
-        (`isVersionInBounds` BackwardsCompatibleWith (Version 0 0 2))
-        [Version 0 0 1, Version 0 0 3, Version 0 1 0, Version 1 0 0]
+spec_SemanticVersion :: Spec
+spec_SemanticVersion = do
+  describe "`show` produces valid semver strings" $ do
+    it "show Version" $ do
+      show (Version 0 0 0) `shouldBe` "0.0.0"
+      show (Version 0 19 0) `shouldBe` "0.19.0"
+      show (Version 1 2 314) `shouldBe` "1.2.314"
+    it "show empty Range" $ do
+      show (mempty :: Range) `shouldBe` ""
+    it "show complex Range" $ do
+      let versionComp1 = (Equal, Version 1 2 3)
+      let versionComp2 = (LessThanOrEqual, Version 1 3 6)
+      let versionComp3 = (BackwardsCompatibleWith, Version 1 2 0)
+      let complexRange =
+            rangeFromVersionsIntersection [versionComp2, versionComp3]
+              <> rangeFromVersion versionComp1
+      show complexRange `shouldBe` "<=1.3.6 ^1.2.0 || =1.2.3"
+  it "concatenating two version ranges with `<>` produces union of their comparator sets" $ do
+    let concatenatedRange =
+          rangeFromVersion (LessThanOrEqual, Version 1 2 3)
+            <> rangeFromVersion (Equal, Version 1 0 0)
+    let expectedRange =
+          Range
+            [ ComparatorSet $ pure $ Comparator LessThanOrEqual (Version 1 2 3),
+              ComparatorSet $ pure $ Comparator Equal (Version 1 0 0)
+            ]
+    concatenatedRange `shouldBe` expectedRange
+  it "mempty of Range is empty Range" $ do
+    mempty `shouldBe` Range []
+  it "rangeFromVersionsIntersection produces version range that puts all version comparators into one comparator set" $ do
+    rangeFromVersionsIntersection [(LessThanOrEqual, Version 1 2 3), (Equal, Version 1 0 0)]
+      `shouldBe` ( Range . pure . ComparatorSet $
+                     fromList [Comparator LessThanOrEqual (Version 1 2 3), Comparator Equal (Version 1 0 0)]
+                 )
+  it "rangeFromVersion produces version range with single version comparator in it" $ do
+    rangeFromVersion (LessThanOrEqual, Version 1 2 3)
+      `shouldBe` (Range . pure . ComparatorSet . pure $ Comparator LessThanOrEqual (Version 1 2 3))
+  describe "isVersionInRange" $ do
+    it "No version is in empty range" $
+      testRange
+        mempty
+        [ ((0, 5, 5), False),
+          ((1, 0, 0), False),
+          ((1, 2, 3), False),
+          ((1, 2, 4), False),
+          ((1, 3, 0), False),
+          ((2, 0, 0), False)
+        ]
+    it "Recognizes only version v to be in range '=v'" $
+      testRange
+        (rangeFromVersion (Equal, Version 1 2 3))
+        [ ((0, 5, 5), False),
+          ((1, 0, 0), False),
+          ((1, 2, 3), True),
+          ((1, 2, 4), False),
+          ((1, 3, 0), False),
+          ((2, 0, 0), False)
+        ]
+    it "Recognizes only versions lesser or equal to v to be in range '<=v'" $
+      testRange
+        (rangeFromVersion (LessThanOrEqual, Version 1 2 3))
+        [ ((0, 5, 5), True),
+          ((1, 0, 0), True),
+          ((1, 2, 3), True),
+          ((1, 2, 4), False),
+          ((1, 3, 0), False),
+          ((2, 0, 0), False)
+        ]
+    describe "Recognizes only versions >=v but smaller than next breaking change to be in range '^v'" $ do
+      it "when v is of shape x.y.z where x != 0." $
+        testRange
+          (rangeFromVersion (BackwardsCompatibleWith, Version 1 2 3))
+          [ ((0, 5, 5), False),
+            ((1, 0, 0), False),
+            ((1, 2, 3), True),
+            ((1, 2, 4), True),
+            ((1, 3, 0), True),
+            ((2, 0, 0), False)
+          ]
+      it "when v is of shape 0.y.z where y != 0." $
+        testRange
+          (rangeFromVersion (BackwardsCompatibleWith, Version 0 2 3))
+          [ ((0, 0, 0), False),
+            ((0, 1, 3), False),
+            ((0, 2, 0), False),
+            ((0, 2, 2), False),
+            ((0, 2, 3), True),
+            ((0, 2, 4), True),
+            ((0, 3, 0), False),
+            ((1, 0, 0), False)
+          ]
+      it "when v is of shape 0.0.z." $
+        testRange
+          (rangeFromVersion (BackwardsCompatibleWith, Version 0 0 2))
+          [ ((0, 0, 1), False),
+            ((0, 0, 2), True),
+            ((0, 0, 3), False),
+            ((0, 1, 0), False),
+            ((1, 0, 0), False)
+          ]
+      it "Correctly works for complex version range." $
+        testRange
+          ( rangeFromVersionsIntersection
+              [ (LessThanOrEqual, Version 1 2 3),
+                (BackwardsCompatibleWith, Version 1 1 0)
+              ]
+              <> rangeFromVersion (Equal, Version 0 5 6)
+          )
+          [ ((0, 5, 5), False),
+            ((0, 5, 6), True),
+            ((0, 5, 7), False),
+            ((1, 0, 9), False),
+            ((1, 1, 0), True),
+            ((1, 1, 9), True),
+            ((1, 2, 3), True),
+            ((1, 2, 4), False),
+            ((1, 3, 0), False),
+            ((2, 0, 0), False)
+          ]
+  where
+    testRange :: Range -> [((Natural, Natural, Natural), Bool)] -> Expectation
+    testRange range versionsWithResults =
+      ( (`isVersionInRange` range) . (\(x, y, z) -> Version x y z)
+          <$> map fst versionsWithResults
+      )
+        `shouldBe` map snd versionsWithResults
--- a/waspc/waspc.cabal
+++ b/waspc/waspc.cabal
@ -28,10 +28,8 @@ data-files:
  Generator/templates/dockerignore
  Generator/templates/react-app/gitignore
  Generator/templates/react-app/npmrc
-  Generator/templates/react-app/nvmrc
  Generator/templates/server/gitignore
  Generator/templates/server/npmrc
-  Generator/templates/server/nvmrc
  Generator/templates/**/*.prisma
  Generator/templates/**/*.toml
  Generator/templates/**/*.json
--- a/web/docs/getting-started.md
+++ b/web/docs/getting-started.md
@ -11,14 +11,14 @@ import useBaseUrl from '@docusaurus/useBaseUrl';

 ## 1. Requirements

-### Node.js compatible with 16.0.0
-```shell-session
-node -v  # must be something like 16.x.x
-```
+You need to have `node` (and `npm`) installed on your machine and available in `PATH`.
+- `node`: >=16.11.0 and <=16.15.0
+- `npm`: >= 8.0.0 and <= 8.5.5

-### NPM compatible with 8.0.0
+You can check `node` and `npm` versions by running:
 ```shell-session
-npm -v  # must be something like 8.x.x
+node -v
+npm -v
 ```

 We recommend using [nvm](https://github.com/nvm-sh/nvm) for managing your Node.js installation version(s).
@ -31,14 +31,14 @@ We recommend using [nvm](https://github.com/nvm-sh/nvm) for managing your Node.j

  Install nvm via your OS package manager (aptitude, pacman, homebrew, ...) or alternatively via [nvm install script](https://github.com/nvm-sh/nvm#install--update-script).

-  Then, install a version of node that you need (any version compatible with 16.0.0), e.g.:
+  Then, install a version of node that you need, e.g.:
  ```shell-session
-  nvm install 16
+  nvm install 16.15.0
  ```

  Finally, whenever you need to ensure specific version of node is used, run e.g.
  ```shell-session
-  nvm use 16
+  nvm use 16.15.0
  ```
  to set the node version for current shell session.

@ -53,6 +53,17 @@ We recommend using [nvm](https://github.com/nvm-sh/nvm) for managing your Node.j
  </div>
 </details>

+:::info
+
+Why does Wasp require this specific `node` range and doesn't support a newer version x.y.z?
+
+At Wasp, we focus on supporting the latest LTS ("long-term-support") Node.js version, since it guarantees stability and active maintainance, which is why official Node.js team recommends it for usage in production.
+Therefore, a specific Wasp release will usually require the version of Node.js that was LTS at that point of time.
+Check out https://nodejs.org/en/about/releases/ for more details about Node.js releases.
+
+Sometimes we will make an exception to that and additionaly limit the Node.js version or postpone switching to the latest LTS if there are certain issues with new Node.js version, in which case we will catch up once those are resolved on Node.js side or we find a workaround on Wasp side.
+
+:::

 ## 2. Installation