📱 Installa come App (PWA)
LibreFolio può essere installato come Progressive Web App (PWA) sul tuo dispositivo. Questo ti offre un'esperienza simile a un'app: modalità a schermo intero, nessuna barra degli indirizzi del browser e un'icona nella schermata home — senza dover scaricare nulla da un app store.
✅ Cosa Ottieni
| Funzionalità | Descrizione |
|---|---|
| Modalità a schermo intero | Nessuna barra degli indirizzi o interfaccia del browser invadente |
| Icona nella schermata home | Avvia LibreFolio come un'app nativa |
| Nessuna interferenza con i gesti | Scorri-indietro e zoom con doppio tocco disabilitati |
| Sessione persistente | Rimane connesso tra un avvio e l'altro |
Solo Online
LibreFolio PWA 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 Install quando richiesto
- LibreFolio apparirà nella tua schermata home
Metodo alternativo
Se il pulsante Install non appare, tocca il menu ⋮ del browser → "Add to Home screen" oppure "Install app".
iOS (Safari)
- Apri LibreFolio in Safari (richiesto — gli altri browser non supportano PWA su iOS)
- Tocca il pulsante Share (quadrato con freccia)
- Scorri verso il basso e tocca "Add to Home Screen"
- Tocca Add
Limitazione iOS
Il prompt di installazione automatica non è disponibile su iOS. Usa il menu Share come descritto sopra. Il menu Help mostrerà le istruzioni se sei 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 apre in una finestra dedicata
🌐 HTTP vs HTTPS
| Configurazione | Installazione PWA | Prompt automatico |
|---|---|---|
https:// (Tailscale, proxy inverso) |
✅ Supporto completo | ✅ Chrome mostra il banner |
http://localhost |
✅ Funziona | ✅ Funziona |
http://192.168.x.x (LAN) |
❌ Non disponibile (richiede HTTPS) | ❌ Nessun prompt automatico |
Requisito di connessione HTTPS per PWA
Per installare LibreFolio come PWA, i browser moderni richiedono strettamente una connessione HTTPS sicura (tranne quando si accede tramite localhost o 127.0.0.1 per lo sviluppo locale).
Se apri LibreFolio su HTTP semplice sulla tua rete locale (ad esempio, http://192.168.1.100:6040), l'installazione PWA non sarà disponibile e l'app non potrà funzionare in modalità autonoma.
Puoi scegliere qualsiasi metodo preferisci per abilitare HTTPS sulla tua istanza, ma raccomandiamo vivamente la nostra semplice guida gratuita: Tailscale Exposure Guide. Ti fornisce un URL HTTPS sicuro senza configurare certificati SSL o aprire porte del router.
🔧 Risoluzione dei problemi
| Problema | Soluzione |
|---|---|
| Il pulsante Installa non appare | Potresti averlo già installato, oppure sei su HTTP in LAN |
| iOS: nessuna opzione di installazione | Devi usare Safari — Chrome/Firefox su iOS non supportano PWA |
| L'app non si aggiorna | Chiudi e riapri l'app — recupera sempre l'ultima versione |
| Sessione persa dopo l'aggiornamento | Accedi di nuovo — è normale dopo il riavvio del server |