From 51c316d4f238829ffc5c4aa7fd9fb209459903d4 Mon Sep 17 00:00:00 2001 From: Daniel Snider Date: Thu, 7 May 2026 18:53:39 -0500 Subject: [PATCH] Add Node.js 26 to supported versions and update examples Adds 26 to the supported nodejs versions in shared/data/registry.json so the {{% latest "nodejs" %}} shortcode resolves to it. Pages that already use the shortcode pick up the new version automatically. For pages that hardcode older versions in generic examples (where the specific version is incidental), switch them to the latest shortcode so they stay current. Bumps the merge-override demo in yaml-structure.md to use 22 and 26 instead of 16 and 20, keeping the divergence the example needs to demonstrate override behaviour. Intentionally left alone: - The "Yarn 3.x and Node.js 14" / "Yarn 3.x and Node.js 16+" codetabs in languages/nodejs/_index.md, which document specific Yarn-on-old-Node compatibility scenarios. - The "Choose Node.js version 20 or above" comment in the Bun examples, which documents Bun's actual minimum required Node version. --- shared/data/registry.json | 1 + sites/platform/src/add-services/network-storage.md | 2 +- sites/platform/src/create-apps/hooks/_index.md | 2 +- .../src/create-apps/multi-app/project-structure.md | 4 ++-- sites/platform/src/create-apps/multi-app/routes.md | 6 +++--- sites/platform/src/languages/nodejs/_index.md | 4 ++-- .../src/learn/overview/yaml/platform-yaml-tags.md | 2 +- sites/platform/src/learn/overview/yaml/yaml-structure.md | 2 +- .../upsun/src/create-apps/multi-app/project-structure.md | 4 ++-- sites/upsun/src/get-started/here/configure/nodejs.md | 6 +++--- .../upsun/src/get-started/stacks/express/add-database.md | 4 ++-- sites/upsun/src/get-started/stacks/strapi/add-database.md | 8 ++++---- sites/upsun/src/languages/nodejs/_index.md | 4 ++-- sites/upsun/src/learn/overview/yaml/platform-yaml-tags.md | 2 +- sites/upsun/src/learn/overview/yaml/yaml-structure.md | 6 +++--- 15 files changed, 29 insertions(+), 28 deletions(-) diff --git a/shared/data/registry.json b/shared/data/registry.json index 814ee3e748..40cdf3e87a 100644 --- a/shared/data/registry.json +++ b/shared/data/registry.json @@ -759,6 +759,7 @@ "4.2" ], "supported": [ + "26", "24", "22", "20" diff --git a/sites/platform/src/add-services/network-storage.md b/sites/platform/src/add-services/network-storage.md index a8918b9f50..9197c2a346 100644 --- a/sites/platform/src/add-services/network-storage.md +++ b/sites/platform/src/add-services/network-storage.md @@ -254,7 +254,7 @@ to be used by a `web` instance and a `queue` worker instance: ```yaml {configFile="apps"} myapp: # The type of the application to build. - type: "nodejs:20" + type: 'nodejs:{{% latest "nodejs" %}}' # Defines how much space is available to local mounts. disk: 512 diff --git a/sites/platform/src/create-apps/hooks/_index.md b/sites/platform/src/create-apps/hooks/_index.md index 2437055b99..8255107a47 100644 --- a/sites/platform/src/create-apps/hooks/_index.md +++ b/sites/platform/src/create-apps/hooks/_index.md @@ -270,7 +270,7 @@ mounts: name: 'nextjs' # The type key specifies the language and version for your app. -type: 'nodejs:14' +type: 'nodejs:{{% latest "nodejs" %}}' dependencies: nodejs: diff --git a/sites/platform/src/create-apps/multi-app/project-structure.md b/sites/platform/src/create-apps/multi-app/project-structure.md index c4a9a04ed3..c87240a046 100644 --- a/sites/platform/src/create-apps/multi-app/project-structure.md +++ b/sites/platform/src/create-apps/multi-app/project-structure.md @@ -111,7 +111,7 @@ api: root: api-app admin: - type: nodejs:16 + type: 'nodejs:{{% latest "nodejs" %}}' mounts: '/.tmp_platformsh': 'shared:files/tmp_platformsh' @@ -139,7 +139,7 @@ admin: root: admin gatsby: - type: 'nodejs:18' + type: 'nodejs:{{% latest "nodejs" %}}' mounts: '/.cache': { source: local, source_path: cache } diff --git a/sites/platform/src/create-apps/multi-app/routes.md b/sites/platform/src/create-apps/multi-app/routes.md index ef3db93cd3..e7c0a194c8 100644 --- a/sites/platform/src/create-apps/multi-app/routes.md +++ b/sites/platform/src/create-apps/multi-app/routes.md @@ -23,7 +23,7 @@ and a Mercure Rocks server app, defined as follows: ```yaml {configFile="apps"} admin: - type: nodejs:16 + type: 'nodejs:{{% latest "nodejs" %}}' source: root: admin ... @@ -33,7 +33,7 @@ api: root: api ... gatsby: - type: nodejs:18 + type: 'nodejs:{{% latest "nodejs" %}}' source: root: gatsby ... @@ -111,7 +111,7 @@ api: index: - index.php admin: - type: nodejs:16 + type: 'nodejs:{{% latest "nodejs" %}}' source: root: admin ... diff --git a/sites/platform/src/languages/nodejs/_index.md b/sites/platform/src/languages/nodejs/_index.md index 2969fb4b6d..5bbf5be488 100644 --- a/sites/platform/src/languages/nodejs/_index.md +++ b/sites/platform/src/languages/nodejs/_index.md @@ -291,7 +291,7 @@ use the following configuration: # The name of your app. name: myapp # Choose Node.js version 20 or above. -type: 'nodejs:20' +type: 'nodejs:{{% latest "nodejs" %}}' # Override the default Node.js build flavor. build: flavor: none @@ -308,7 +308,7 @@ You can even [use Bun as a runtime](https://devcenter.upsun.com/posts/bun-suppor # The name of your app. name: myapp # Choose Node.js version 20 or above. -type: 'nodejs:20' +type: 'nodejs:{{% latest "nodejs" %}}' # Override the default Node.js build flavor. build: flavor: none diff --git a/sites/platform/src/learn/overview/yaml/platform-yaml-tags.md b/sites/platform/src/learn/overview/yaml/platform-yaml-tags.md index 5c8a1cec59..624171c0f4 100644 --- a/sites/platform/src/learn/overview/yaml/platform-yaml-tags.md +++ b/sites/platform/src/learn/overview/yaml/platform-yaml-tags.md @@ -30,7 +30,7 @@ For example, to include another ``.platform/app1.yaml`` file in the main `{{% ve ```yaml {location=".platform/app1.yaml"} source: root: "/" -type: "nodejs:20" +type: 'nodejs:{{% latest "nodejs" %}}' web: commands: start: "node index.js" diff --git a/sites/platform/src/learn/overview/yaml/yaml-structure.md b/sites/platform/src/learn/overview/yaml/yaml-structure.md index ab1af70546..8e34205b50 100644 --- a/sites/platform/src/learn/overview/yaml/yaml-structure.md +++ b/sites/platform/src/learn/overview/yaml/yaml-structure.md @@ -85,7 +85,7 @@ app1: root: app1 app2: - type: nodejs:20 + type: 'nodejs:{{% latest "nodejs" %}}' source: root: app2 ``` diff --git a/sites/upsun/src/create-apps/multi-app/project-structure.md b/sites/upsun/src/create-apps/multi-app/project-structure.md index 17c08ffc60..51188a75f5 100644 --- a/sites/upsun/src/create-apps/multi-app/project-structure.md +++ b/sites/upsun/src/create-apps/multi-app/project-structure.md @@ -103,7 +103,7 @@ applications: root: api-app admin: - type: nodejs:16 + type: 'nodejs:{{% latest "nodejs" %}}' mounts: '/.tmp_platformsh': 'shared:files/tmp_platformsh' @@ -131,7 +131,7 @@ applications: root: admin gatsby: - type: 'nodejs:18' + type: 'nodejs:{{% latest "nodejs" %}}' mounts: '/.cache': { source: tmp, source_path: cache } diff --git a/sites/upsun/src/get-started/here/configure/nodejs.md b/sites/upsun/src/get-started/here/configure/nodejs.md index 4b4695a66e..3e0e1f5ca5 100644 --- a/sites/upsun/src/get-started/here/configure/nodejs.md +++ b/sites/upsun/src/get-started/here/configure/nodejs.md @@ -44,7 +44,7 @@ applications: myapp: source: root: "/" - type: "nodejs:20" + type: 'nodejs:{{% latest "nodejs" %}}' web: commands: start: "npx next start -p $PORT" @@ -77,7 +77,7 @@ applications: myapp: source: root: "/" - type: "nodejs:20" + type: 'nodejs:{{% latest "nodejs" %}}' web: commands: start: "node index.js" @@ -111,7 +111,7 @@ applications: myapp: source: root: "/" - type: "nodejs:20" + type: 'nodejs:{{% latest "nodejs" %}}' relationships: postgresql: mounts: diff --git a/sites/upsun/src/get-started/stacks/express/add-database.md b/sites/upsun/src/get-started/stacks/express/add-database.md index c7d0e90282..4f9c1ce754 100644 --- a/sites/upsun/src/get-started/stacks/express/add-database.md +++ b/sites/upsun/src/get-started/stacks/express/add-database.md @@ -32,7 +32,7 @@ applications: myapp: source: root: "/" - type: "nodejs:20" + type: 'nodejs:{{% latest "nodejs" %}}' [...] @@ -48,7 +48,7 @@ applications: myapp: source: root: "/" - type: "nodejs:20" + type: 'nodejs:{{% latest "nodejs" %}}' [...] diff --git a/sites/upsun/src/get-started/stacks/strapi/add-database.md b/sites/upsun/src/get-started/stacks/strapi/add-database.md index 5d487455d0..5a3dc39314 100644 --- a/sites/upsun/src/get-started/stacks/strapi/add-database.md +++ b/sites/upsun/src/get-started/stacks/strapi/add-database.md @@ -52,7 +52,7 @@ applications: myapp: source: root: "/" - type: "nodejs:20" + type: 'nodejs:{{% latest "nodejs" %}}' [...] @@ -70,7 +70,7 @@ applications: myapp: source: root: "/" - type: "nodejs:20" + type: 'nodejs:{{% latest "nodejs" %}}' [...] @@ -93,7 +93,7 @@ applications: myapp: source: root: "/" - type: "nodejs:20" + type: 'nodejs:{{% latest "nodejs" %}}' [...] @@ -114,7 +114,7 @@ applications: myapp: source: root: "/" - type: "nodejs:20" + type: 'nodejs:{{% latest "nodejs" %}}' [...] diff --git a/sites/upsun/src/languages/nodejs/_index.md b/sites/upsun/src/languages/nodejs/_index.md index e6ce5fa21c..7c2947be3c 100644 --- a/sites/upsun/src/languages/nodejs/_index.md +++ b/sites/upsun/src/languages/nodejs/_index.md @@ -283,7 +283,7 @@ applications: # The name of your app. myapp: # Choose Node.js version 20 or above. - type: 'nodejs:20' + type: 'nodejs:{{% latest "nodejs" %}}' # Override the default Node.js build flavor. build: flavor: none @@ -301,7 +301,7 @@ applications: # The name of your app. myapp: # Choose Node.js version 20 or above. - type: 'nodejs:20' + type: 'nodejs:{{% latest "nodejs" %}}' # Override the default Node.js build flavor. build: flavor: none diff --git a/sites/upsun/src/learn/overview/yaml/platform-yaml-tags.md b/sites/upsun/src/learn/overview/yaml/platform-yaml-tags.md index b6202990cf..6f2285d0b4 100644 --- a/sites/upsun/src/learn/overview/yaml/platform-yaml-tags.md +++ b/sites/upsun/src/learn/overview/yaml/platform-yaml-tags.md @@ -207,7 +207,7 @@ For [multiple application](/create-apps/multi-app/_index.md) project, you can al ```yaml {location=".upsun/apps/my-app.yaml"} source: root: "/" -type: "nodejs:18" +type: 'nodejs:{{% latest "nodejs" %}}' web: commands: start: "node index.js" diff --git a/sites/upsun/src/learn/overview/yaml/yaml-structure.md b/sites/upsun/src/learn/overview/yaml/yaml-structure.md index 0e8bac694f..3a1054cfe7 100644 --- a/sites/upsun/src/learn/overview/yaml/yaml-structure.md +++ b/sites/upsun/src/learn/overview/yaml/yaml-structure.md @@ -65,7 +65,7 @@ Example: ```yaml {location=".upsun/app.yaml"} applications: myapp: - type: nodejs:16 + type: nodejs:22 source: root: folder1 ... @@ -74,7 +74,7 @@ applications: ```yaml {location=".upsun/app-bis.yaml"} applications: myapp: - type: nodejs:20 + type: nodejs:26 build: flavor: none ... @@ -85,7 +85,7 @@ the blended configuration will be the following: ```yaml {location="YAML config result"} applications: myapp: - type: nodejs:20 + type: nodejs:26 build: flavor: none ...