Connectez un projet Atoms à Supabase lorsque vous souhaitez que l'app utilise une base de données Supabase, l'authentification, le stockage de fichiers ou des fonctions backend.

Ce guide vous accompagne tout au long du processus complet : préparer un compte et un projet Supabase, autoriser la bonne organisation, connecter le projet, vérifier que la connexion a fonctionné et la déconnecter si nécessaire.

Comment fonctionne la connexion

Chaque projet Supabase appartient à une organisation, qui contrôle qui peut accéder aux projets qu'elle contient et les gérer. Lorsque vous connectez Supabase à Atoms, vous autorisez d'abord Atoms à accéder à l'organisation que vous souhaitez utiliser, puis vous sélectionnez un projet de cette organisation à connecter.

Chaque projet Atoms peut être connecté à un seul projet Supabase à la fois. Cependant, le même projet Supabase peut être connecté à plusieurs projets Atoms.

Supabase et Cloud Atoms sont des options backend alternatives. Vous ne pouvez pas connecter les deux au même projet Atoms en même temps.

Avant de commencer

Avant de connecter Supabase, assurez-vous que :

• Vous êtes le propriétaire de l'espace de travail Atoms qui contient le projet. Seul le propriétaire de l'espace de travail peut autoriser, connecter ou déconnecter Supabase.
• Vous avez un compte Supabase, ou vous êtes prêt à en créer un pendant la configuration.
• Vous avez l'autorisation d'autoriser l'organisation Supabase et d'accéder au projet avec lequel vous souhaitez vous connecter.
• L'Agent a terminé sa tâche en cours et le Mode Course est désactivé.
• Votre navigateur autorise les fenêtres pop-up provenant d'Atoms.
• Votre projet Atoms n'est pas déjà connecté à Cloud Atoms.

Si vous essayez cette connexion pour la première fois, envisagez d'utiliser un projet de test pendant que vous apprenez le processus.

Ne collez jamais un mot de passe Supabase, une clé API, un jeton d'accès ou tout autre identifiant dans le Chat.

Connexion Supabase

Ouvrir le connecteur Supabase

1. Ouvrez le projet que vous souhaitez connecter.
2. Cliquez sur le nom du projet, en haut à droite du panneau de chat.
3. Sélectionnez Connectors dans le menu déroulant qui apparaît.
4. Trouvez Supabase dans la liste des connecteurs disponibles, puis cliquez sur connect.

Vous pouvez également ouvrir Settings → Connectors → Supabase et sélectionner Connect.

Ouvrez Settings → Connectors et sélectionnez Connect pour Supabase.

Autoriser Atoms dans Supabase

Si Organizations affiche déjà l'organisation Supabase que vous souhaitez utiliser, elle a déjà été autorisée. Vous pouvez continuer vers Choose the Supabase project.

1. Atoms ouvre une fenêtre d'autorisation Supabase. Connectez-vous au compte Supabase que vous souhaitez connecter, ou créez un nouveau compte si nécessaire.
2. Vérifiez que vous êtes connecté au bon compte Supabase, puis sélectionnez l'organisation à laquelle vous souhaitez donner accès à Atoms.
3. Examinez les autorisations demandées par Atoms. Pour voir chaque autorisation, sélectionnez Show detailed permissions. Si vous êtes d'accord, sélectionnez Authorize Atoms.
4. Retournez dans Atoms et attendez le message Connect success.
5. Dans Atoms, ouvrez Connectors → Supabase et confirmez que l'organisation apparaît sous Organizations.

Atoms demande un accès en lecture et en écriture à Base de données, Secrets, Auth, Edge Functions, Environment, Projects, PostgREST et Storage. Il demande également un accès en lecture à Organizations et Domains. Ces autorisations permettent à Atoms de connecter et de gérer les services Supabase pris en charge utilisés par votre projet.

Cette autorisation s'applique à l'organisation Supabase sélectionnée et n'est pas limitée au projet Supabase que vous connecterez ensuite au projet Atoms actuel. Atoms ne peut pas accéder aux organisations ou projets auxquels le compte Supabase connecté n'a pas lui-même accès, et les autorisations Supabase peuvent imposer des restrictions supplémentaires.

Examinez l'organisation et les autorisations avant d'autoriser Atoms.

Choisir le projet Supabase

1. Sous Organizations, développez l'organisation que vous avez autorisée.
2. Sous Projects, trouvez le projet Supabase actif que vous souhaitez connecter.
3. Si l'organisation dont vous avez besoin n'est pas répertoriée, sélectionnez New Organization et autorisez-la. Cela ne crée pas une nouvelle organisation Supabase ; cela vous permet d'autoriser une autre organisation qui existe déjà dans votre compte Supabase.
4. Si vous n'avez pas encore de projet, sélectionnez Create Project et créez-en un dans Supabase. Attendez que le projet soit actif et prêt à être utilisé, puis retournez dans Atoms et sélectionnez Update pour actualiser la liste des projets.
5. À côté du projet que vous souhaitez utiliser, sélectionnez Connect.

Choisissez un projet Supabase dans l'organisation autorisée.

Confirmer le projet

1. Dans la fenêtre de confirmation, vérifiez l'organisation et le projet affichés sous Supabase Project.
2. Si nécessaire, utilisez Supabase Dashboard ou View Tables pour confirmer que vous avez sélectionné le bon projet.
3. Sélectionnez Connect.
4. Atoms ajoute un élément de connexion Supabase au Chat du projet. Gardez la page ouverte et attendez qu'il se termine avant de demander à l'Agent de créer une base de données, une fonctionnalité d'authentification, de stockage ou de backend.

Confirmez le projet Supabase sélectionné avant de vous connecter.

Vérifier que la connexion a fonctionné

1. Ouvrez Settings → Connectors → Supabase.
2. Confirmez que la bonne organisation et le bon projet Supabase sont affichés comme connectés.
3. Sélectionnez Dashboard ou Tables et vérifiez que cela ouvre le même projet dans Supabase.

Le panneau du projet connecté peut également inclure des liens vers Manage Users, SQL Editor, Edge Functions et Manage Secrets. Vous n'avez besoin d'utiliser que les zones pertinentes pour les fonctionnalités que vous créez.

Examinez le projet Supabase connecté et ses liens de gestion.

Tester que votre app peut enregistrer des données

Connecter Supabase n'ajoute pas à lui seul une fonctionnalité de base de données à votre app. Dans Chat, demandez à l'Agent de créer la fonctionnalité souhaitée et d'utiliser le projet Supabase connecté pour stocker ses données. Une fois que l'Agent a terminé, testez le parcours complet.

1. Dans Chat, décrivez la fonctionnalité souhaitée, quelles informations elle doit enregistrer et où les utilisateurs doivent revoir ces informations. Dites à l'Agent d'utiliser le projet Supabase connecté.
2. Attendez que l'Agent ait terminé de créer la fonctionnalité.
3. Dans la Visionneuse d'App, utilisez la fonctionnalité comme le ferait un utilisateur et saisissez des données de test sans risque. N'utilisez pas d'informations personnelles, confidentielles ou sensibles.
4. Actualisez la Visionneuse d'App ou rouvrez la fonctionnalité. Confirmez que les informations enregistrées restent présentes et apparaissent au bon endroit.
5. Ouvrez Settings → Connectors → Supabase, sélectionnez Tables et confirmez que l'enregistrement correspondant apparaît dans la bonne table.

Si la fonctionnalité permet aux utilisateurs de modifier ou de supprimer des informations enregistrées, testez également ces actions et confirmez que les résultats sont corrects à la fois dans l'app et dans Supabase. Le fait que les modifications effectuées directement dans Supabase apparaissent immédiatement dans l'app dépend de la manière dont l'app a été créée.

Déconnecter Supabase

Déconnectez Supabase lorsque vous ne souhaitez plus que le projet Atoms actuel utilise le projet Supabase connecté.

1. Ouvrez Settings → Connectors → Supabase.
2. Confirmez que vous consultez la connexion du bon projet Atoms.
3. Sélectionnez Disconnect Project.
4. Attendez que l'élément de déconnexion Supabase dans Chat se termine.
5. Rouvrez Connectors → Supabase et confirmez que le projet n'est plus affiché comme connecté.

La déconnexion supprime la connexion du projet Atoms actuel. Elle ne supprime pas le projet Supabase ni ses données, et elle ne supprime pas l'autorisation de l'organisation Supabase.

Toutes les fonctionnalités de votre projet Atoms qui dépendent de Supabase peuvent cesser de fonctionner après sa déconnexion. Si votre app est déjà publiée, vous devrez peut-être mettre à jour la version publiée avant que le changement ne prenne effet. Testez à la fois votre projet et l'app en ligne après la déconnexion.

Déconnecter Supabase d'un projet Atoms n'affecte pas les autres projets Atoms connectés au même projet Supabase.

FAQ

Pourquoi ma connexion Supabase a-t-elle cessé de fonctionner ?

1. Ouvrez le Supabase Dashboard et vérifiez l'état du projet concerné. Un projet du Forfait Gratuit à faible activité peut être mis en pause après une période de sept jours.
2. S'il est en pause, sélectionnez Resume project et attendez que Supabase indique qu'il est actif.
3. Retournez dans Atoms, ouvrez le panneau Connectors du projet et vérifiez la connexion Supabase. Réessayez l'action qui échoue une fois.
4. Si Supabase est déjà actif, relevez l'erreur exacte d'Atoms ou de Supabase et vérifiez si la connexion est affichée comme déconnectée ou expirée. Reconnectez-la uniquement lorsque l'état indique que c'est nécessaire.

Ne faites pas tourner les clés et ne créez pas de projet de remplacement tant que vous ne connaissez pas la cause et que vous n'avez pas protégé les données existantes. Si le problème persiste, contactez le support avec le Chat Link, l'heure et le fuseau horaire, l'état de la connexion et une capture d'écran de l'erreur expurgée.

Référence externe : Supabase — Mise en pause du projet

Comment reconnecter un projet Supabase qui a été mis en pause ?

1. Connectez-vous à la bonne organisation Supabase et ouvrez le projet mis en pause.
2. Sélectionnez Resume project et attendez que son état soit actif. Les indications actuelles de Supabase précisent que les projets du Forfait Gratuit à faible activité peuvent être mis en pause après une période de sept jours de faible activité.
3. Retournez dans Atoms et ouvrez le panneau Connectors du projet. Confirmez que Supabase est connecté, puis réessayez l'opération concernée.
4. Si Atoms affiche toujours le connecteur comme déconnecté ou expiré, reconnectez-le et terminez l'autorisation demandée.

Ne créez pas de nouveau projet Supabase et ne faites pas tourner les identifiants tant que les données existantes ne sont pas protégées. Si la reconnexion échoue, fournissez au support le Chat Link, l'état du projet Supabase, l'heure et le fuseau horaire, ainsi qu'une capture d'écran de l'erreur expurgée.

Référence externe : Supabase — Mise en pause du projet