rafgraph/spa-github-pages
Spa Github Pages
Este proyecto es una solución de enrutamiento del lado del cliente y gestor de URL diseñado para aplicaciones de una sola página (SPA) alojadas en plataformas estáticas, específicamente GitHub Pages. Permite que estas aplicaciones manejen enlaces profundos (deep links) y mantengan un enrutamiento funcional en hosts que no soportan redirecciones del lado del servidor.
El sistema intercepta los errores 404 del servidor y los redirige a un punto de entrada principal, utilizando cadenas de consulta y fragmentos hash para preservar el estado de la aplicación y restaurar la ruta original deseada. También incluye utilidades para generar enlaces especializados compatibles con redirecciones para sitemaps, asegurando que los motores de búsqueda puedan indexar las páginas sin activar errores del servidor.
El proyecto ofrece soporte integral para la gestión de rutas, la preservación del estado de la URL y la optimización para motores de búsqueda (SEO) en entornos de sitios estáticos.
Features
- 404 Page Redirections - Intercepts static host 404 errors and redirects them to the root to enable client-side routing.
- URL Parameter Persistence - Ensures the browser maintains the correct path and query parameters when redirecting back to the main entry point.
- Client-side Routing - Provides a mechanism to intercept missing page requests and redirect them to maintain application state.
- Fragment Preservation - Maintains URL hash fragments and query parameters during redirects to ensure the correct application view loads.
- Route Redirects - Provides utilities to redirect server-side errors on static hosts back to the main entry point.
- Static Route Interception - Uses a custom fallback page to simulate dynamic routing on a platform that only supports static files.
- Static Site Error Pages - Intercepts 404 errors on static hosts to preserve application state and redirect users to the home page.
- Static SPA Routers - Provides a client-side routing solution that enables single page applications to handle deep links on GitHub Pages.
- Client-Side URL Rewriters - Encodes destination paths in query strings to bypass server-side routing limitations on static platforms.
- URL State Restoration - Reroutes missing page requests to a main entry point using query strings to recover the original application state.
- Single Page Application Hosting - Implements fallback routing to serve a single HTML file for all application paths on static hosts.
- SPA Routing Configurations - Enables hosting of single page applications on GitHub Pages while maintaining functional client-side routing.
- Sitemap Redirects - Transforms standard URLs into redirect-compatible links for sitemaps to enable indexing despite server-side errors.
- Static Site SEO - Creates search engine friendly links for single page apps hosted on platforms without server-side redirects.
- Sitemap Generators - Generates search engine friendly links that function correctly on static hosting services.
- Redirect-Compatible Sitemaps - Generates specialized sitemap URLs that bypass server-side errors by encoding the intended destination path.
- SEO Link Encoding - Transforms standard paths into specialized links that bypass server-side errors for search engine indexing.
