Application web (PWA)

L’application Mindwtr pour ordinateur peut fonctionner dans un navigateur au moyen de la compilation Vite. Dans un navigateur, hors Tauri, elle utilise localStorage pour la persistance et enregistre un service worker pour le fonctionnement hors ligne et la PWA.

---

Exécution locale

Vous pouvez exécuter la PWA en local avec Bun ou Docker.

Avec Docker — recommandé

Consultez Déploiement Docker pour exécuter le conteneur PWA.

Avec Bun

Depuis la racine du dépôt :

bun install
bun desktop:web

Vite démarre sur http://localhost:5173/.

---

Compilation pour l’hébergement

bun desktop:web:build

Le résultat se trouve dans apps/desktop/dist/ et peut être hébergé comme site statique.

---

Comportement de la PWA

• L’application enregistre apps/desktop/public/sw.js dans le navigateur.
• sw.js met en cache au préalable /, /index.html, /manifest.webmanifest, /icon.png et /logo.png. Il ne met ensuite en cache à la demande que les ressources statiques, comme les scripts, styles, images et polices. Les requêtes d’API et de synchronisation restent sur le réseau.
• Les requêtes de navigation utilisent d’abord le réseau et ne reviennent à l’enveloppe d’application mise en cache que hors ligne.
• La vue actuelle est enregistrée dans ?view=. L’actualisation et les liens copiés conservent donc le même écran sans configuration de routes sur l’hébergement statique. Les filtres ne sont pas encodés dans l’URL.

---

Exigences d’hébergement

Hébergez apps/desktop/dist/ à la racine du site (/). Le service worker est enregistré depuis /sw.js et le manifeste utilise des chemins absolus.

Assurez-vous que l’hébergeur statique sert :

• manifest.webmanifest comme application/manifest+json, recommandé ;
• sw.js comme application/javascript.

Pour héberger sous un sous-chemin comme /mindwtr/, adaptez l’enregistrement du service worker et les chemins du manifeste au chemin de base.

---

Limites

• Les versions navigateur stockent les données dans localStorage ; effacer les données du site efface donc celles de Mindwtr.
• Certaines fonctions réservées à l’ordinateur peuvent manquer, notamment les pièces jointes qui nécessitent un accès natif aux fichiers.
• Aucun accès natif à la zone de notification ni aux raccourcis globaux.

---

Voir aussi

• Guide du développeur
• Données et synchronisation