Changelog
Action recommended - Node.js 18 end-of-life and impact on Pages Build System V2
- If you are using Pages Build System V2 for a Git-connected Pages project, note that the default Node.js version, Node.js 18, will end its LTS support on April 30, 2025.
- Pages will not change the default Node.js version in the Build System V2 at this time, instead, we strongly recommend pinning a modern Node.js version to ensure your builds are consistent and secure.
- You can pin any Node.js version by:
- Adding a
NODE_VERSIONenvironment variable with the desired version specified as the value. - Adding a
.node-versionfile with the desired version specified in the file.
- Adding a
- Pinning helps avoid unexpected behavior and ensures your builds stay up-to-date with your chosen runtime. We also recommend pinning all critical tools and languages that your project relies on.
Support for pnpm 10 in build system
- Pages build system now supports building projects that use pnpm 10 as the package manager. If your build previously failed due to this unsupported version, retry your build. No config changes needed.
Cloudflare GitHub App Permissions Update
- Cloudflare is requesting updated permissions for the Cloudflare GitHub App to enable features like automatically creating a repository on your GitHub account and deploying the new repository for you when getting started with a template. This feature is coming out soon to support a better onboarding experience.
- Requested permissions:
- Repository Administration (read/write) to create repositories.
- Contents (read/write) to push code to the created repositories.
- Who is impacted:
- Existing users will be prompted to update permissions when GitHub sends an email with subject "[GitHub] Cloudflare Workers & Pages is requesting updated permission" on December 19th, 2024.
- New users installing the app will see the updated permissions during the connecting repository process.
- Action: Review and accept the permissions update to use upcoming features. If you decline or take no action, you can continue connecting repositories and deploying changes via the Cloudflare GitHub App as you do today, but new features requiring these permissions will not be available.
- Questions? Visit #github-permissions-update in the Cloudflare Developers Discord.
- Requested permissions:
Updating Bun version to 1.1.33 in V2 build system
- Bun version is being updated from
1.0.1to1.1.33in Pages V2 build system. This is a minor version change, please see details at Bun. - If you wish to use a previous Bun version, you can override default version.
Support for D1's new storage subsystem and build error message improvements
- Added support for D1's new storage subsystem. All Git builds and deployments done with Wrangler v3.5.0 and up can use the new subsystem.
- Builds which fail due to exceeding the build time limit will return a proper error message indicating so rather than
Internal error. - New and improved error messages for other build failures
Commit message limit increase
- Commit messages can now be up to 384 characters before being trimmed.
Build error message improvement
- Builds which fail due to Out of memory (OOM) will return a proper error message indicating so rather than
Internal error.
V2 build system beta
- The V2 build system is now available in open beta. Enable the V2 build system by going to your Pages project in the Cloudflare dashboard and selecting Settings > Build & deployments > Build system version.
Support for Smart Placement
- Smart placement can now be enabled for Pages within your Pages Project by going to Settings > Functions.
Git projects can now see files uploaded
- Files uploaded are now visible for Git projects, you can view them in the Cloudflare dashboard.
Notifications for Pages are now available
- Notifications for Pages events are now available in the Cloudflare dashboard. Events supported include:
- Deployment started.
- Deployment succeeded.
- Deployment failed.
Analytics Engine now available in Functions
- Added support for Analytics Engine in Functions.
Queues now available in Functions
- Added support for Queues producer in Functions.
Ability to delete aliased deployments
- Aliased deployments can now be deleted. If using the API, you will need to add the query parameter
force=true.
Deep linking to a Pages deployment
- You can now deep-link to a Pages deployment in the dashboard with
:pages-deployment. An example would behttps://dash.cloudflare.com?to=/:account/pages/view/:pages-project/:pages-deployment.
Functions GA and other updates
- Pages functions are now GA. For more information, refer to the blog post.
- We also made the following updates to Functions:
- Functions metrics are now available in the dashboard.
- Functions billing is now available.
- The Unbound usage model is now available for Functions.
- Secrets are now available.
- Functions tailing is now available via the dashboard or with Wrangler (
wrangler pages deployment tail).
Service bindings now available in Functions
- Service bindings are now available in Functions. For more details, refer to the docs.
Deep linking to a Pages project
- You can now deep-link to a Pages project in the dashboard with
:pages-project. An example would behttps://dash.cloudflare.com?to=/:account/pages/view/:pages-project.
Increased domain limits
Previously, all plans had a maximum of 10 custom domains per project.
Now, the limits are:
- Free: 100 custom domains.
- Pro: 250 custom domains.
- Business and Enterprise: 500 custom domains.
Support for _routes.json
- Pages now offers support for
_routes.json. For more details, refer to the documentation.
Increased build log expiration time
Build log expiration time increased from 2 weeks to 1 year.
New bindings supported
- R2 and D1 bindings are now supported.
Added support for .dev.vars in wrangler pages
Pages now supports .dev.vars in wrangler pages, which allows you to use use environmental variables during your local development without chaining --envs.
This functionality requires Wrangler v2.0.16 or higher.
Added deltas to wrangler pages publish
Pages has added deltas to wrangler pages publish.
We now keep track of the files that make up each deployment and intelligently only upload the files that we have not seen. This means that similar subsequent deployments should only need to upload a minority of files and this will hopefully make uploads even faster.
This functionality requires Wrangler v2.0.11 or higher.