Run your Pages application locally with our Wrangler Command Line Interface (CLI).
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>
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.