V3 Pages Build image

Author: shahsimpson

src/content/docs/pages/configuration/build-image.mdx

@@ -78,23 +78,23 @@ You can add the following environment variable to disable automatic dependency i
 | ------------------------- | ------------- |
 | `SKIP_DEPENDENCY_INSTALL` | `1` or `true` |
 
-## V2 build system
+## v3 build system
 
-The [v2 build system](https://blog.cloudflare.com/moderizing-cloudflare-pages-builds-toolbox/) announced in May 2023 brings several improvements to project builds.
+The v3 build system updates the default tools, libraries and languages to their LTS versions, as of May 2025.
 
-### V1 to V2 Migration
+### v2 to v3 Migration
 
 To migrate to this new version, configure your Pages project settings in the dashboard:
 
 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com) and select your account.
 2. Select **Workers & Pages** > in **Overview**, select your Pages project.
 3. Go to **Settings** > **Build & deployments** > **Build system version** and select the latest version.
 
-If you were previously relying on the default versions of any languages or tools in the build system, your build may fail when migrating to v2. To fix this, you must specify the version you wish to use by [overriding](/pages/configuration/build-image/#overriding-default-versions) the default versions.
+If you were previously relying on the default versions of any languages or tools in the build system, your build may fail when migrating to v3. To fix this, you must specify the version you wish to use by [overriding](/pages/configuration/build-image/#overriding-default-versions) the default versions.
 
 ### Limitations
 
-The following features are not currently supported when using the v2 build system:
+The following features are not currently supported when using the v3 build system:
 
 - Specifying Node.js versions as codenames (for example, `hydrogen` or `lts/hydrogen`).
 - Detecting Yarn version from `yarn.lock` file version.

src/content/pages-build-environment/v3.yaml

@@ -0,0 +1,67 @@
+major_version: 3
+enable_date: "2025-05-30"
+languages:
+  - name: Go
+    default: "1.21.0"
+    supported: "Any version"
+    environment_variable: "GO_VERSION"
+  - name: Node.js
+    default: "22.15.1"
+    supported: "Any version"
+    environment_variable: "NODE_VERSION"
+    file:
+      - ".nvmrc"
+      - ".node-version"
+  - name: Python
+    default: "3.11.5"
+    supported: "Any version"
+    environment_variable: "PYTHON_VERSION"
+    file:
+      - ".python-version"
+      - "runtime.txt"
+  - name: Ruby
+    default: "3.2.2"
+    supported: "Any version"
+    environment_variable: "RUBY_VERSION"
+    file:
+      - ".ruby-version"
+tools:
+  - name: Bundler
+    default: "2.4.10"
+    supported: "Corresponds with Ruby version"
+  - name: Embedded Dart Sass
+    default: "1.62.1"
+    supported: "Up to 1.62.1"
+    environment_variable: "EMBEDDED_DART_SASS_VERSION"
+  - name: gem
+    default: "3.4.10"
+    supported: "Corresponds with Ruby version"
+  - name: Hugo
+    default: "0.118.2"
+    supported: "Any version"
+    environment_variable: "HUGO_VERSION"
+  - name: npm
+    default: "10.9.2"
+    supported: "Corresponds with Node.js version"
+  - name: pip
+    default: "23.2.1"
+    supported: "Corresponds with Python version"
+  - name: pipx
+    default: "1.2.0"
+  - name: pnpm
+    default: "10.11.0"
+    supported: "Any version"
+    environment_variable: "PNPM_VERSION"
+  - name: Poetry
+    default: "1.6.1"
+  - name: Yarn
+    default: "4.9.1"
+    supported: "Any version"
+    environment_variable: "YARN_VERSION"
+  - name: Bun
+    default: "1.2.13"
+    supported: "Any version"
+    environment_variable: "BUN_VERSION"
+build_environment:
+  operating_system: "Ubuntu `22.04.2`"
+  architecture: "x86_64"