Need a guide for server configuration of index.html Fallback

[andreawyss]

It is still very hard to find online complete and correct examples on how to configure various servers for History pushState.

When using ReactRouter (History pushState API) it should be simple to find and understand how to correctly configure any popular server:

• webpack
• express
• ngnix
• ... and other popular web servers

Given that a SPA can be just a portion on the full served website these are the requirements:

/my-base/index.html is where the actual index exists for a spa
/my-base/route/sub-route must fallback to index.html located in '/my-base'
/my-base/route/abc.js must not fallback because name has a period
/some-base/route/sub-route must not fallback because it is not under my-base

/other-spa/index.html is where the actual index exists for another spa
/other-spa/route/sub-route must fallback to index.html located in '/other-spa'
/other-spa/route/abc.js must not fallback because name has a period
/some-base/route/sub-route must not fallback because it is not under other-spa

It is clear that this is not react-router problem but it still greatly impacts the developer experience of using the library when one cannot find how to setup the server correctly.

A simple page in the guides with links to relevant servers configuration on how to correctly achieve this would be really helpful.

The lack of this information forces many projects to use HashRouter just because no one on the team could get BrowserRouter to work in the dev and prod environments.