📱 Installer comme application (PWA)
LibreFolio peut être installé en tant qu'application web progressive (PWA) sur votre appareil. Cela vous offre une expérience proche d'une application native : mode plein écran, absence de barre d'adresse du navigateur et icône sur l'écran d'accueil — sans téléchargement depuis un magasin d'applications.
✅ Ce que vous obtenez
| Fonctionnalité | Description |
|---|---|
| Mode plein écran | Pas de barre d'adresse ni d'interface encombrée du navigateur |
| Icône sur l'écran d'accueil | Lancez LibreFolio comme une application native |
| Aucune interférence gestuelle | Balayage arrière et zoom par double tap désactivés |
| Session persistante | Restez connecté entre les lancements |
En ligne uniquement
La PWA LibreFolio nécessite une connexion réseau active. Il n'y a pas de mode hors ligne — vos données résident sur votre serveur.
📲 Comment installer
Android (Chrome / Edge)
- Ouvrez LibreFolio dans Chrome ou Edge
- Recherchez le bouton "Installer l'application" dans le menu Aide et support (icône ❓ en haut à droite)
- Appuyez sur Installer lorsque vous y êtes invité
- LibreFolio apparaît sur votre écran d'accueil
Méthode alternative
Si le bouton d'installation n'apparaît pas, appuyez sur le menu ⋮ → "Ajouter à l'écran d'accueil" ou "Installer l'application".
iOS (Safari)
- Ouvrez LibreFolio dans Safari (obligatoire — les autres navigateurs ne prennent pas en charge les PWA sur iOS)
- Appuyez sur le bouton Partager (carré avec une flèche)
- Faites défiler vers le bas et appuyez sur "Ajouter à l'écran d'accueil"
- Appuyez sur Ajouter
Limitation iOS
L'invite d'installation automatique n'est pas disponible sur iOS. Utilisez le menu Partager comme décrit ci-dessus. Le menu Aide affichera des instructions si vous êtes sur un appareil iOS.
Bureau (Chrome / Edge)
- Ouvrez LibreFolio dans Chrome ou Edge
- Cliquez sur le bouton "Installer l'application" dans le menu Aide et support
- Ou cliquez sur l'icône d'installation (⊕) dans la barre d'adresse du navigateur
- LibreFolio s'ouvre dans sa propre fenêtre
🌐 HTTP vs HTTPS
| Configuration | Installation PWA | Invite automatique |
|---|---|---|
https:// (Tailscale, proxy inverse) |
✅ Prise en charge complète | ✅ Chrome affiche la bannière |
http://localhost |
✅ Fonctionne | ✅ Fonctionne |
http://192.168.x.x (LAN) |
❌ Non disponible (HTTPS requis) | ❌ Pas d'invite automatique |
Exigence de connexion HTTPS pour la PWA
Pour installer LibreFolio en tant que PWA, les navigateurs modernes exigent strictement une connexion HTTPS sécurisée (sauf lors de l'accès via localhost ou 127.0.0.1 pour le développement local).
Si vous ouvrez LibreFolio en HTTP simple sur votre réseau local (par exemple, http://192.168.1.100:6040), l'installation de la PWA ne sera pas disponible et l'application ne pourra pas fonctionner en mode autonome.
Vous pouvez choisir n'importe quelle méthode pour activer HTTPS sur votre instance, mais nous recommandons fortement notre guide simple et gratuit : Guide d'exposition Tailscale. Il vous fournit une URL HTTPS sécurisée sans configurer de certificats SSL ni ouvrir de ports routeur.
🔧 Dépannage
| Problème | Solution |
|---|---|
| Le bouton d'installation n'apparaît pas | Vous l'avez peut-être déjà installée, ou vous êtes en HTTP sur le LAN |
| iOS : pas d'option d'installation | Vous devez utiliser Safari — Chrome/Firefox sur iOS ne prennent pas en charge les PWA |
| L'application ne se met pas à jour | Fermez et rouvrez l'application — elle récupère toujours la dernière version |
| Session perdue après une mise à jour | Reconnectez-vous — c'est normal après un redémarrage du serveur |