Cloudflare Docs
Edit this page on GitHub
Set theme to dark (⇧+D)

Local development

Run your Pages application locally with our Wrangler Command Line Interface (CLI).

​​ Install Wrangler

To get started with Wrangler, refer to the Install/Update Wrangler.

​​ Run your Pages project locally

The main command for local development on Pages is wrangler pages dev. This will let you run your Pages application locally, which includes serving static assets and running your Functions.

With your folder of static assets set up, run the following command to start local development:

$ npx wrangler pages dev <DIRECTORY-OF-ASSETS>

This will then start serving your Pages project. You can press b to open the browser on your local site.

If you are using a framework, you can pass through the framework-provided dev command (such as, npm run dev) to run development. This enables you to benefit from the framework hot-reloading and any special build process around it. To run a framework-provided dev command:

$ npx wrangler pages dev -- <COMMAND>

This will start a local Wrangler development server that serves your Pages project. It will also spawn a new process, running the provided <COMMAND>. This provided command is expected to start its own local server, which serves static assets. Wrangler will proxy requests for assets to this underlying server. You can press b to open the browser on your local site, (available, by default, on http://localhost:8788).

​​ HTTPS support

To serve your local development server over HTTPS with a self-signed certificate, pass the --local-protocol=https argument to npx wrangler pages dev:

$ npx wrangler pages dev --local-protocol=https <DIRECTORY-OF-ASSETS>

If you are using npx wrangler pages dev with a command (-- <COMMAND>), you must match the protocol of whatever server is spun up by that command. If using HTTPS, you must additionally specify the certificate path to Node.js to allow Wrangler to accept responses from the command’s server. You can do this by specifying the NODE_EXTRA_CA_CERTS environment variable:

$ NODE_EXTRA_CA_CERTS=<PATH_TO_CERTIFICATE> npx wrangler pages dev --local-protocol=https -- <COMMAND>

​​ Attach bindings to local development

To attach a binding to local development, refer to Bindings and find the resource you would like to work with.