Cloudflare Pages Frontend

1. Click Compute (Workers) -> Workers & Pages -> Create

   

2. Select Pages, choose Use direct upload

   

3. Enter the deployed worker address. It must be the backend API root URL, start with https://, and must not include a trailing /. Click generate, and if successful, a download button will appear. You will get a zip package.

   • The worker domain here is the backend API domain. For example, if I deployed at https://temp-email-api.awsl.uk, then fill in https://temp-email-api.awsl.uk
   • If your domain is https://temp-email-api.xxx.workers.dev, then fill in https://temp-email-api.xxx.workers.dev
   • Do not enter your frontend Pages domain, and do not include paths like /admin or /api. Otherwise frontend requests will hit the wrong address and you may see Cannot read properties of undefined (reading 'map') or 405 Method Not Allowed

   Note

   The worker.dev domain is not accessible in China, please use a custom domain.

   Example: `https://temp-email-api.example.com`. Do not enter the frontend Pages domain and do not add a trailing `/`.

   NOTE

   You can also deploy manually. Download the zip from here: frontend.zip

   Modify the index-xxx.js file in the archive, where xx is a random string

   Search for https://temp-email-api.xxx.xxx and replace it with your worker's backend API root URL, then deploy the new zip file. If you replace it with the frontend Pages domain, common symptoms are the map error or 405 responses from API requests

4. Select Pages, click Create Pages, modify the name, upload the downloaded zip package

   Important: SPA Mode

   This project is a Single-Page Application (SPA). You must expand the advanced options during deployment and set "Not Found handling" to Single-page application (SPA). Otherwise, refreshing the page or directly accessing sub-paths like /admin will return a 404 error.

   

   Then click Deploy

   

5. Open the Pages you just deployed, click Custom Domain. Here you can add your own domain, or you can use the automatically generated *.pages.dev domain. If you can open the domain, the deployment is successful.