📱 Installa come App (PWA)
LibreFolio può essere installato come Progressive Web App (PWA) sul tuo dispositivo. Questo ti offre un'esperienza simile a quella di un'app: modalità a schermo intero, nessuna barra degli indirizzi del browser e un'icona sulla schermata home — senza dover scaricare nulla da un app store.
✅ Cosa Ottieni
| Funzionalità | Descrizione |
|---|---|
| Modalità a schermo intero | Nessuna barra degli indirizzi o elementi dell'interfaccia del browser |
| Icona nella schermata home | Avvia LibreFolio come un'app nativa |
| Nessuna interferenza dai gesti | Swipe-back e zoom con doppio tocco disabilitati |
| Sessione persistente | Resta connesso tra un avvio e l'altro |
Online Only
La PWA di LibreFolio richiede una connessione di rete attiva. Non esiste una modalità offline: i tuoi dati risiedono sul tuo server.
📲 Come Installare
Android (Chrome / Edge)
- Apri LibreFolio in Chrome o Edge
- Cerca il pulsante "Install App" nel menu Help & Support (icona ❓ in alto a destra)
- Tocca Installa quando richiesto
- LibreFolio apparirà sulla tua schermata home
Alternative method
Se il pulsante di installazione non appare, tocca il menu ⋮ del browser → "Aggiungi alla schermata Home" o "Installa app".
iOS (Safari)
- Apri LibreFolio in Safari (obbligatorio — gli altri browser non supportano le PWA su iOS)
- Tocca il pulsante Condividi (quadrato con freccia)
- Scorri verso il basso e tocca "Aggiungi alla schermata Home"
- Tocca Aggiungi
iOS Limitation
Il prompt di installazione automatica non è disponibile su iOS. Utilizza il menu Condividi come descritto sopra. Il menu Help & Support mostrerà le istruzioni se ti trovi su un dispositivo iOS.
Desktop (Chrome / Edge)
- Apri LibreFolio in Chrome o Edge
- Clicca sul pulsante "Install App" nel menu Help & Support
- Oppure clicca sull'icona di installazione (⊕) nella barra degli indirizzi del browser
- LibreFolio si aprirà in una finestra dedicata
🌐 HTTP vs HTTPS
| Setup | PWA Install | Auto-prompt |
|---|---|---|
https:// (Tailscale, reverse proxy) |
✅ Supporto completo | ✅ Chrome mostra il banner |
http://localhost |
✅ Funziona | ✅ Funziona |
http://192.168.x.x (LAN) |
⚠️ Solo manuale | ❌ Nessun prompt automatico |
Self-hosted on LAN
Se accedi a LibreFolio via HTTP sulla tua rete locale (es. http://192.168.1.100:6040), il prompt di installazione automatica non apparirà. Puoi comunque installarlo manualmente:
- Android: Menu del browser → "Aggiungi alla schermata Home"
- iOS: Condividi → "Aggiungi alla schermata Home"
- Desktop: Non disponibile su HTTP (usa Tailscale per HTTPS)
Per il pieno supporto PWA, esponi la tua istanza tramite Tailscale (HTTPS gratuito e semplice).
🔧 Troubleshooting
| Problema | Soluzione |
|---|---|
| Il pulsante di installazione non appare | Potresti averlo già installato, oppure sei su HTTP LAN |
| iOS: nessuna opzione di installazione | Devi usare Safari — Chrome/Firefox su iOS non supportano le PWA |
| L'app non si aggiorna | Chiudi e riapri l'app — scarica sempre l'ultima versione |
| Sessione persa dopo l'aggiornamento | Effettua nuovamente il login — è normale dopo il riavvio del server |