You may tell Cloudflare Pages how your site needs to be built as well as where its output files will be located.
Build commands and directories
You should provide a build command to tell Cloudflare Pages how to build your application. For projects not listed here, consider reading the tool's documentation or framework, and submit a pull request to add it here.
Build directories indicates where your project's build command outputs the built version of your Cloudflare Pages site. Often, this defaults to the industry-standard
public, but you may find that you need to customize it.
Cloudflare maintains a list of build configurations for popular frameworks and tools. These are accessible during project creation. Below are some standard build commands and directories for popular frameworks and tools.
If you are not using a framework, you may input
exit 0 into the Build command field.
|Framework/tool||Build command||Build directory|
|Angular (Angular CLI)|
|Next.js (Static HTML Export)|
If your project makes use of environment variables to build your site, you can provide custom environment variables by going to Account Home > Pages > your Pages project > Settings > Environment variables.
The following system environment variables are injected by default (but can be overridden):
|Environment Variable||Injected value||Example use-case|
|Changing build behaviour when run on Pages versus locally|
|Passing current commit ID to error reporting, for example, Sentry|
|Customizing build based on branch, for example, disabling debug logging on |
Language support and tools
Cloudflare Pages' build environment has broad support for a variety of languages, such as Ruby, Node.js, Python, PHP, and Go.
If you need to use a specific version of a language, (for example, Node.js or Ruby) you can specify it by providing an associated environment variable in your build configuration, or setting the relevant file in your source code.
Here are the pinned versions for tools included in the Cloudflare Workers build environment, and how to override them as relevant:
|Framework||Default version||Environment variable||File|
Many common tools have been pre-installed as well. The environment variable available for overriding the pinned version is specified, as available:
|Gutenberg||(requires environment variable)|
|GNU Make||Version 3.8.1|
|NPM||Corresponds with Node.js version|
|pip||Corresponds with Python version|
|Zola||(requires environment variable)|
If you want to set a specific version of a framework your Cloudflare Pages project is using, note that Pages will respect your package manager of choice during your build process. For example, if you use Gatsby.js, your
package.json should indicate a version of the
gatsby npm package, which will be installed using
npm install as your project builds on Cloudflare Pages.