Wat is GitHub Pages SPA 404-helper?
GitHub Pages serveert statische bestanden en kent geen client-side routes tenzij een overeenkomend bestand bestaat. Een single-page app kan 404 tonen wanneer een bezoeker direct een diepe route opent. Een 404-fallback kan de browser terugsturen naar het app-ingangspunt terwijl het gevraagde pad behouden blijft voor de router.
Snel antwoord
Genereer een 404.html-fallback voor single-page apps die op GitHub Pages zijn geïmplementeerd. De fallback stuurt diepe client-side routes door naar het app-ingangspunt terwijl het oorspronkelijke pad behouden blijft voor de router.
Last updated: 2026-06-11
Beperkingen
- Dit is een generieke client-side fallback, geen server-side omleidingsconfiguratie. Het vertrouwt op JavaScript in de browser om het oorspronkelijke pad te extraheren en door te geven aan de router.
- De client-side router moet worden geconfigureerd om het behouden pad uit de query string of hash te lezen en de bijbehorende route weer te geven. Niet alle routers verwerken dit omleidingspatroon automatisch.
- Deze aanpak lost navigatie- of verversingsgedrag binnen de SPA na de initiële omleiding niet op. Router-niveau configuratie is nog steeds nodig voor volledige client-side routing-ondersteuning.
Sources:MDN Web Docs · W3C Specifications · jquery.app on GitHub
Zo gebruik je deze tool
- Voer het app-basispad in. Gebruik / voor een gebruikers- of aangepast domein, of /repo-naam/ voor een projectpagina.
- Kies of de fallback het oorspronkelijke pad moet opslaan in de query string of hash.
- Kopieer het gegenereerde 404.html-bestand naar de gepubliceerde site-root.
- Test een diepe route direct na implementatie.
Waarvoor je het kunt gebruiken
- Repareer directe bezoeken aan client-side routes op GitHub Pages.
- Bereid een 404-fallback voor voor React-, Vue-, Svelte- of vanilla-routers.
- Documenteer het benodigde basispad voor projectpagina's.