Run your Pages application locally with our Wrangler Command Line Interface (CLI).
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 ).
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 environment variable:
$ NODE_EXTRA_CA_CERTS=<PATH_TO_CERTIFICATE> npx wrangler pages dev --local-protocol=https -- <COMMAND>