Fallback for SPA should support files other than index.html

[nktnet1]

Description

Currently, there is the following option (mentioned in #664):

-s, --single                        Rewrite all not-found requests to `index.html`

However, this option is limited and does not support loading custom HTML as mentioned by @woss in:

• It is really missing the fallback option for not found urls #695 (comment)

Why

Frameworks like Tanstack Start generates _shell.html by default for SPA, rather than index.html:

• [RFC] SPA Mode Enhancements TanStack/router#3394

• https://tanstack.com/start/v0/docs/framework/react/guide/spa-mode#how-does-it-work

  

Alternatives

A workaround can be seen here:

• fix(tanstack-start): api search for SPA with serve fuma-nama/fumadocs#3378

Where serve.json is created with a rewrite:

{
  "rewrites": [
    {
      "source": "!/api/**",
      "destination": "/_shell.html"
    }
  ]
}

This isn't ideal, however, since the rewrite works on all paths rather than serving as a fallback, which masks the API route - thus, it needs to be excluded in the source glob. There may also be other exclusions needed apart from /api.