Qué es Ayudante 404 para SPA en GitHub Pages?
GitHub Pages sirve archivos estáticos y no conoce rutas del lado del cliente a menos que exista un archivo coincidente. Una aplicación de una sola página puede mostrar 404 cuando un visitante abre una ruta profunda directamente. Un fallback 404 puede redirigir el navegador de vuelta al punto de entrada de la aplicación mientras preserva la ruta solicitada para el enrutador.
Respuesta rápida
Genere un fallback 404.html para aplicaciones de una sola página implementadas en GitHub Pages. El fallback redirige las rutas profundas del lado del cliente al punto de entrada de la aplicación preservando la ruta original.
Last updated: 2026-06-11
Limitaciones
- Es un fallback genérico del lado del cliente, no una configuración de redirección del servidor.
- El enrutador del lado del cliente debe configurarse para leer la ruta preservada.
- Este enfoque no corrige la navegación o el comportamiento de actualización dentro de la SPA.
Sources:MDN Web Docs · W3C Specifications · jquery.app on GitHub
Cómo usar esta herramienta
- Ingrese la ruta base de la aplicación. Use / para un sitio de usuario o dominio personalizado, o /nombre-repo/ para una página de proyecto.
- Elija si el fallback debe almacenar la ruta original en la cadena de consulta o en el hash.
- Copie el archivo 404.html generado en la raíz del sitio publicado.
- Pruebe una ruta profunda directamente después de la implementación.
Para qué puedes usarla
- Corregir visitas directas a rutas del lado del cliente en GitHub Pages.
- Preparar un fallback 404 para enrutadores React, Vue, Svelte o vanilla.
- Documentar la ruta base necesaria para páginas de proyecto.