---
# quotesdb-tzvj
title: '[TRIAGE] Cloudflare Pages SPA routing — 404 fallback config for client-side Yew router'
status: completed
type: task
priority: critical
created_at: 2026-03-10T23:32:11Z
updated_at: 2026-03-10T23:32:11Z
---

<context>
This is a triage decision ticket. It must be resolved before dependent implementation tickets can proceed.
</context>

<question>
Cloudflare Pages SPA routing: Yew uses client-side routing. A direct URL to `/browse` or `/quotes/:id` will 404 on Cloudflare Pages unless a fallback is configured.
</question>

<options>
1. **\_redirects file** — add a `_redirects` file to the `dist/` directory: `/* /index.html 200`. Cloudflare Pages supports this.
2. **\_headers file** — configure headers; does not fix routing by itself.
3. **Cloudflare Pages custom 404 page** — set `404.html` to be the same as `index.html`. Less clean.
</options>

<resolution>
**Chosen approach: Option 1 — `_redirects` file.**

- File content: `/* /index.html 200`
- The `200` code is a Cloudflare Pages "proxy" (not a redirect): it serves `index.html` content
  while preserving the original URL in the browser. This is required for Yew's BrowserRouter to
  function correctly on direct navigation and page reloads.
- The file lives at the `quotesdb/` project root and is copied into `dist/` by Trunk via
  `<link data-trunk rel="copy-file" href="_redirects"/>` in `index.html`.
- Cloudflare Pages processes `_redirects` automatically from the uploaded artifact — no
  OpenTofu changes are needed in `ae886f`.
- The `/api/*` Worker routes are claimed at the Cloudflare routing layer before Pages processes
  requests, so the `/* /index.html 200` catch-all does not interfere with the API.

Options 2 (`_headers`) and 3 (duplicate `404.html`) were ruled out:
- `_headers` does not fix routing — it only sets response headers.
- A `404.html` copy of `index.html` returns HTTP 404 status, which is incorrect for valid SPA
  routes and can harm SEO and caching behaviour.

Implementation ticket: **9ef703** — creates the `_redirects` file and adds the Trunk copy-file
directive to `index.html`. `dc3d2b` (Trunk.toml) depends on 9ef703 to ensure the copy-file
line is not accidentally overwritten. `ae886f` (Pages resource) updated with resolved notes.
</resolution>

<commit>
`chore(quotesdb): resolve triage — cloudflare-pages-spa-routing-404-fallback-config-for-clients`
</commit>