diff --git a/src/content/docs/pages/configuration/build-image.mdx b/src/content/docs/pages/configuration/build-image.mdx index 8a2412df6075e6a..1b5675178e3b955 100644 --- a/src/content/docs/pages/configuration/build-image.mdx +++ b/src/content/docs/pages/configuration/build-image.mdx @@ -78,11 +78,11 @@ 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: @@ -90,11 +90,11 @@ To migrate to this new version, configure your Pages project settings in the das 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. diff --git a/src/content/pages-build-environment/v3.yaml b/src/content/pages-build-environment/v3.yaml new file mode 100644 index 000000000000000..66422253b9efd8a --- /dev/null +++ b/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"