📱 Instalar como aplicación (PWA)
LibreFolio se puede instalar como una Aplicación Web Progresiva (PWA) en tu dispositivo. Esto te brinda una experiencia similar a una aplicación nativa: modo de pantalla completa, sin barra de direcciones del navegador y un icono en la pantalla de inicio, sin necesidad de descargarla desde una tienda de aplicaciones.
✅ Lo que obtienes
| Característica | Descripción |
|---|---|
| Modo de pantalla completa | Sin barra de direcciones ni interfaz del navegador |
| Icono en la pantalla de inicio | Inicia LibreFolio como una aplicación nativa |
| Sin interferencia de gestos | Deslizar hacia atrás y zoom con doble toque desactivados |
| Sesión persistente | Permanece conectado entre inicios |
Solo con conexión
La PWA de LibreFolio requiere una conexión de red activa. No hay modo sin conexión: tus datos residen en tu servidor.
📲 Cómo instalar
Android (Chrome / Edge)
- Abre LibreFolio en Chrome o Edge
- Busca el botón "Instalar aplicación" en el menú Ayuda y soporte (icono ❓ en la esquina superior derecha)
- Toca Instalar cuando se te solicite
- LibreFolio aparece en tu pantalla de inicio
Método alternativo
Si el botón de Instalar no aparece, toca el menú ⋮ del navegador → "Agregar a la pantalla de inicio" o "Instalar aplicación".
iOS (Safari)
- Abre LibreFolio en Safari (obligatorio: otros navegadores no admiten PWA en iOS)
- Toca el botón Compartir (cuadrado con flecha)
- Desplázate hacia abajo y toca "Agregar a la pantalla de inicio"
- Toca Agregar
Limitación de iOS
La solicitud automática de instalación no está disponible en iOS. Usa el menú Compartir como se describe arriba. El menú de Ayuda mostrará instrucciones si estás en un dispositivo iOS.
Escritorio (Chrome / Edge)
- Abre LibreFolio en Chrome o Edge
- Haz clic en el botón "Instalar aplicación" en el menú Ayuda y soporte
- O haz clic en el icono de instalación (⊕) en la barra de direcciones del navegador
- LibreFolio se abre en su propia ventana
🌐 HTTP vs HTTPS
| Configuración | Instalación PWA | Solicitud automática |
|---|---|---|
https:// (Tailscale, proxy inverso) |
✅ Soporte completo | ✅ Chrome muestra el banner |
http://localhost |
✅ Funciona | ✅ Funciona |
http://192.168.x.x (LAN) |
❌ No disponible (HTTPS requerido) | ❌ Sin solicitud automática |
Requisito de conexión HTTPS para PWA
Para instalar LibreFolio como PWA, los navegadores modernos exigen estrictamente una conexión HTTPS segura (excepto cuando se accede a través de localhost o 127.0.0.1 para desarrollo local).
Si abres LibreFolio a través de HTTP simple en tu red local (por ejemplo, http://192.168.1.100:6040), la instalación de la PWA no estará disponible y la aplicación no podrá ejecutarse en modo independiente.
Puedes elegir cualquier método que prefieras para habilitar HTTPS en tu instancia, pero recomendamos encarecidamente nuestra guía simple y gratuita: Guía de exposición con Tailscale. Te proporciona una URL HTTPS segura sin necesidad de configurar certificados SSL ni abrir puertos del enrutador.
🔧 Solución de problemas
| Problema | Solución |
|---|---|
| El botón Instalar no aparece | Puede que ya lo tengas instalado, o estés usando HTTP en la LAN |
| iOS: sin opción de instalar | Debes usar Safari — Chrome/Firefox en iOS no admiten PWA |
| La aplicación no se actualiza | Ciérrala y vuélvela a abrir: siempre obtiene la versión más reciente |
| Sesión perdida tras la actualización | Vuelve a iniciar sesión; esto es normal después de reiniciar el servidor |