docs: add SPA settings screenshot (#975)

This commit is contained in:
Dream Hunter
2026-04-12 21:03:05 +08:00
committed by GitHub
parent 163df5c908
commit e81c9d0d9c
5 changed files with 8 additions and 0 deletions

View File

@@ -12,6 +12,8 @@ Refer to [Deploy Worker](/en/guide/cli/worker#deploy-worker-with-frontend-option
> [!warning] Important: SPA Mode
> This project is a Single-Page Application (SPA). If you deploy manually via the Cloudflare dashboard, **you must set "Not Found handling" to `Single-page application (SPA)` in the advanced options**, otherwise refreshing the page or directly accessing sub-paths like `/admin` will return a 404 error.
> When deploying via CLI (`wrangler pages deploy`), this is handled automatically and no extra configuration is needed.
>
> ![pages spa setting](/ui_install/pages-spa-setting.jpg)
The first deployment will prompt you to create a project. For the `production` branch, enter `production`.

View File

@@ -139,6 +139,8 @@ const generate = async () => {
> [!warning] 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.
>
> ![pages spa setting](/ui_install/pages-spa-setting.jpg)
Then click `Deploy`

Binary file not shown.

After

Width:  |  Height:  |  Size: 31 KiB

View File

@@ -12,6 +12,8 @@
> [!warning] 重要SPA 模式
> 本项目是单页应用SPA。如果你通过 Cloudflare 控制台手动上传部署,**必须在高级选项中将「未找到处理」设置为 `Single-page application (SPA)`**,否则刷新页面或直接访问 `/admin` 等子路径时会返回 404。
> 通过 CLI`wrangler pages deploy`)部署时会自动处理,无需额外配置。
>
> ![pages spa setting](/ui_install/pages-spa-setting.jpg)
第一次部署会提示创建项目, `production` 分支请填写 `production`

View File

@@ -139,6 +139,8 @@ const generate = async () => {
> [!warning] 重要SPA 模式
> 本项目是单页应用SPA**必须在部署时展开高级选项,将「未找到处理」设置为 `Single-page application (SPA)`**。
> 否则刷新页面或直接访问 `/admin` 等子路径时会返回 404。
>
> ![pages spa setting](/ui_install/pages-spa-setting.jpg)
然后点击 `Deploy`