Grist Widget Bridge

About

Grist Widget Bridge est une extension utilitaire qui débloque les widgets personnalisés Grist hébergés sur un domaine externe (La Forge, GitHub Pages, votre propre serveur…).

Sans cette extension, les widgets cross-origin rencontrent deux problèmes systématiques :
1. L'API Grist refuse les requêtes pour cause de CORS
2. localStorage est bloqué par le navigateur (DOMException "The operation is insecure")

Cette extension corrige ces deux problèmes de manière propre, sécurisée et configurable.

🚀 FONCTIONNALITÉS

✅ Multi-instances — fonctionne avec n'importe quel serveur Grist (grist.numerique.gouv.fr, votre Grist auto-hébergé, gristlabs.com…)
✅ Multi-widgets — accepte autant d'origines de widgets que vous voulez (forge.apps.education.fr, github.io, votre site…)
✅ Menu en un clic — l'icône d'extension détecte l'onglet courant et propose « + Comme instance Grist » ou « + Comme widget » sans configuration manuelle
✅ Pont d'upload natif — les pièces jointes envoyées depuis le widget sont relayées via la session Grist existante (cookie), pas besoin d'API key
✅ Proxy localStorage transparent — bascule automatiquement vers chrome.storage quand le navigateur bloque localStorage, sans rien changer dans le code du widget
✅ Aucune URL en dur — l'extension n'est active que sur les adresses que vous avez explicitement configurées

🛡️ SÉCURITÉ

- Aucune donnée n'est envoyée à un serveur tiers
- L'extension n'agit QUE sur les URLs que vous avez configurées
- Le pont d'upload n'accepte les messages que d'iframes enfants connues
- Vérification stricte de l'origine du message à chaque appel
- Pas d'accès aux données du document, uniquement à l'API d'attachement

📋 CAS D'USAGE

- Widgets personnalisés Kanban, Calendrier, Gantt hébergés sur La Forge
- Widgets développés en interne hébergés sur votre intranet
- Tests locaux de widgets pendant le développement (localhost)
- Multi-tenant : plusieurs Grist d'organisations différentes

⚡ INSTALLATION RAPIDE

1. Installez l'extension
2. Ouvrez votre page Grist → cliquez l'icône → « + Comme instance Grist »
3. Ouvrez votre page widget → cliquez l'icône → « + Comme widget »
4. Rechargez les onglets — c'est tout

🔓 CODE SOURCE VISIBLE

Le code est entièrement local et lisible : aucun serveur distant, aucune télémétrie.

— Pour qui ?
Toute personne qui développe ou utilise des widgets personnalisés Grist sur un domaine externe : DSI, intégrateurs, formateurs, développeurs.