Verbind een Atoms-project met Supabase wanneer je wilt dat de app een Supabase-database, authenticatie, bestandsopslag of backendfuncties gebruikt.

Deze handleiding neemt je mee door het volledige traject: een Supabase-account en -project voorbereiden, de juiste organisatie autoriseren, het project verbinden, controleren of de verbinding werkte en deze loskoppelen wanneer nodig.

Hoe de verbinding werkt

Elk Supabase-project behoort tot een organisatie, die bepaalt wie toegang heeft tot en beheer kan uitvoeren over de projecten daarin. Wanneer je Supabase met Atoms verbindt, autoriseer je eerst Atoms om toegang te krijgen tot de organisatie die je wilt gebruiken, en selecteer je daarna een project uit die organisatie om te verbinden.

Elk Atoms-project kan slechts met één Supabase-project tegelijk verbonden zijn. Hetzelfde Supabase-project kan echter met meer dan één Atoms-project verbonden zijn.

Supabase en Atoms Cloud zijn alternatieve backendopties. Je kunt niet beide tegelijk met hetzelfde Atoms-project verbinden.

Voordat je begint

Controleer voordat je Supabase verbindt of:

• Je de eigenaar van de Atoms-werkruimte bent die het project bevat. Alleen de eigenaar van de werkruimte kan Supabase autoriseren, verbinden of loskoppelen.
• Je een Supabase-account hebt, of klaar bent om er tijdens de installatie een aan te maken.
• Je toestemming hebt om de Supabase-organisatie te autoriseren en toegang hebt tot het project waarmee je wilt verbinden.
• De Agent zijn huidige taak heeft voltooid en Race Modus is uitgeschakeld.
• Je browser pop-upvensters van Atoms toestaat.
• Je Atoms-project nog niet met Atoms Cloud is verbonden.

Als je deze verbinding voor het eerst probeert, overweeg dan om een testproject te gebruiken terwijl je het proces leert kennen.

Plak nooit een Supabase-wachtwoord, API-sleutel, toegangstoken of andere inloggegevens in Chat.

Supabase Verbinden

Open de Supabase-connector

1. Open het project dat je wilt verbinden.
2. Klik op de projectnaam rechtsboven in het chatpaneel.
3. Selecteer Connectors in het dropdownmenu dat verschijnt.
4. Zoek Supabase in de lijst met beschikbare connectors en klik op verbinden.

Je kunt ook Settings → Connectors → Supabase openen en Connect selecteren.

Open Settings → Connectors en selecteer Connect voor Supabase.

Autoriseer Atoms in Supabase

Als Organizations al de Supabase-organisatie toont die je wilt gebruiken, is deze al geautoriseerd. Je kunt doorgaan naar Kies het Supabase-project.

1. Atoms opent een Supabase-autorisatievenster. Meld je aan bij het Supabase-account waarmee je wilt verbinden, of maak indien nodig een nieuw account aan.
2. Controleer of je bent aangemeld bij het juiste Supabase-account en selecteer vervolgens de organisatie waartoe Atoms toegang moet krijgen.
3. Controleer de machtigingen die Atoms aanvraagt. Om elke machtiging te zien, selecteer Show detailed permissions. Als je akkoord gaat, selecteer Authorize Atoms.
4. Ga terug naar Atoms en wacht op het bericht Connect success.
5. Open in Atoms Connectors → Supabase en bevestig dat de organisatie onder Organizations verschijnt.

Atoms vraagt lees- en schrijftoegang aan voor Database, Secrets, Auth, Edge Functions, Environment, Projects, PostgREST en Storage. Het vraagt ook leestoegang aan voor Organizations en Domains. Deze machtigingen stellen Atoms in staat om de ondersteunde Supabase-services die door je project worden gebruikt te verbinden en te beheren.

Deze autorisatie geldt voor de geselecteerde Supabase-organisatie en is niet beperkt tot het Supabase-project dat je later met het huidige Atoms-project verbindt. Atoms heeft geen toegang tot organisaties of projecten waartoe het verbonden Supabase-account zelf geen toegang heeft, en Supabase-machtigingen kunnen aanvullende beperkingen opleggen.

Controleer de organisatie en machtigingen voordat je Atoms autoriseert.

Kies het Supabase-project

1. Vouw onder Organizations de organisatie uit die je hebt geautoriseerd.
2. Zoek onder Projects het actieve Supabase-project dat je wilt verbinden.
3. Als de organisatie die je nodig hebt niet in de lijst staat, selecteer dan New Organization en autoriseer deze. Dit maakt geen nieuwe Supabase-organisatie aan; het stelt je in staat om een andere organisatie te autoriseren die al in je Supabase-account bestaat.
4. Als je nog geen project hebt, selecteer dan Create Project en maak er een aan in Supabase. Wacht tot het project actief en klaar voor gebruik is, ga dan terug naar Atoms en selecteer Update om de projectlijst te vernieuwen.
5. Selecteer naast het project dat je wilt gebruiken Connect.

Kies een Supabase-project uit de geautoriseerde organisatie.

Bevestig het project

1. Controleer in het bevestigingsvenster de organisatie en het project die onder Supabase Project worden weergegeven.
2. Gebruik indien nodig Supabase Dashboard of View Tables om te bevestigen dat je het juiste project hebt geselecteerd.
3. Selecteer Connect.
4. Atoms voegt een Supabase-verbindingsitem toe aan de project-Chat. Houd de pagina open en wacht tot dit is voltooid voordat je de Agent vraagt een database-, authenticatie-, opslag- of backendfunctie te bouwen.

Bevestig het geselecteerde Supabase-project voordat je verbindt.

Controleer of de verbinding werkte

1. Open Settings → Connectors → Supabase.
2. Bevestig dat de juiste organisatie en het juiste Supabase-project als verbonden worden weergegeven.
3. Selecteer Dashboard of Tables en controleer of hetzelfde project in Supabase wordt geopend.

Het paneel van het verbonden project kan ook links bevatten naar Manage Users, SQL Editor, Edge Functions en Manage Secrets. Je hoeft alleen de onderdelen te gebruiken die relevant zijn voor de functies die je bouwt.

Controleer het verbonden Supabase-project en de beheerlinks ervan.

Test of je app gegevens kan opslaan

Het verbinden van Supabase voegt niet vanzelf een databasefunctie toe aan je app. Vraag in Chat de Agent om de functie te bouwen die je wilt en gebruik het verbonden Supabase-project om de gegevens ervan op te slaan. Test na voltooiing door de Agent het volledige traject.

1. Beschrijf in Chat de functie die je wilt, welke informatie deze moet opslaan en waar gebruikers die informatie opnieuw moeten zien. Vertel de Agent om het verbonden Supabase-project te gebruiken.
2. Wacht tot de Agent klaar is met het bouwen van de functie.
3. Gebruik in de App Viewer de functie zoals een gebruiker dat zou doen en voer onschuldige testgegevens in. Gebruik geen persoonlijke, vertrouwelijke of gevoelige informatie.
4. Vernieuw de App Viewer of open de functie opnieuw. Bevestig dat de opgeslagen informatie behouden blijft en op de juiste plaats verschijnt.
5. Open Settings → Connectors → Supabase, selecteer Tables en bevestig dat de overeenkomende record in de juiste tabel verschijnt.

Als de functie gebruikers toestaat opgeslagen informatie te bewerken of te verwijderen, test die acties dan ook en bevestig dat de resultaten zowel in de app als in Supabase correct zijn. Of wijzigingen die direct in Supabase worden aangebracht onmiddellijk in de app verschijnen, hangt af van hoe de app is gebouwd.

Supabase loskoppelen

Koppel Supabase los wanneer je niet langer wilt dat het huidige Atoms-project het verbonden Supabase-project gebruikt.

1. Open Settings → Connectors → Supabase.
2. Bevestig dat je de verbinding voor het juiste Atoms-project bekijkt.
3. Selecteer Disconnect Project.
4. Wacht tot het Supabase-loskoppelitem in Chat is voltooid.
5. Open Connectors → Supabase opnieuw en bevestig dat het project niet langer als verbonden wordt weergegeven.

Loskoppelen verwijdert de verbinding uit het huidige Atoms-project. Het verwijdert het Supabase-project of de gegevens ervan niet, en het verwijdert ook de autorisatie voor de Supabase-organisatie niet.

Functies in je Atoms-project die afhankelijk zijn van Supabase kunnen stoppen met werken nadat je het hebt losgekoppeld. Als je app al is gepubliceerd, moet je mogelijk de gepubliceerde versie bijwerken voordat de wijziging van kracht wordt. Test zowel je project als de live app na het loskoppelen.

Het loskoppelen van Supabase van één Atoms-project heeft geen invloed op andere Atoms-projecten die met hetzelfde Supabase-project zijn verbonden.

FAQ

Waarom werkt mijn Supabase-verbinding niet meer?

1. Open het Supabase Dashboard en controleer de status van het getroffen project. Een Gratis Plan-project met weinig activiteit kan na een periode van zeven dagen worden gepauzeerd.
2. Als het is gepauzeerd, selecteer dan Resume project en wacht tot Supabase meldt dat het actief is.
3. Ga terug naar Atoms, open het Connectors-paneel van het project en controleer de Supabase-verbinding. Probeer de mislukte actie één keer opnieuw.
4. Als Supabase al actief is, leg dan de exacte Atoms- of Supabase-fout vast en controleer of de verbinding als losgekoppeld of verlopen wordt weergegeven. Verbind alleen opnieuw wanneer de status aangeeft dat dit nodig is.

Draai sleutels niet om en maak geen vervangend project aan totdat je de oorzaak kent en bestaande gegevens hebt beschermd. Als de storing aanhoudt, neem dan contact op met Support met de Chat Link, tijd en tijdzone, verbindingsstatus en een opgeschoonde foutscreenshot.

Externe referentie: Supabase — Project Pausing

Hoe verbind ik opnieuw een Supabase-project dat was gepauzeerd?

1. Meld je aan bij de juiste Supabase-organisatie en open het gepauzeerde project.
2. Selecteer Resume project en wacht tot de status actief is. Volgens de huidige Supabase-richtlijnen kunnen Gratis Plan-projecten met weinig activiteit worden gepauzeerd na een periode van zeven dagen met lage activiteit.
3. Ga terug naar Atoms en open het Connectors-paneel van het project. Bevestig dat Supabase is verbonden en probeer daarna de betreffende bewerking opnieuw.
4. Als Atoms de connector nog steeds als losgekoppeld of verlopen weergeeft, verbind deze dan opnieuw en voltooi de gevraagde autorisatie.

Maak geen nieuw Supabase-project aan en roteer geen inloggegevens totdat bestaande gegevens zijn beschermd. Als opnieuw verbinden mislukt, geef Support dan de Chat Link, de status van het Supabase-project, tijd en tijdzone, en een opgeschoonde foutscreenshot.

Externe referentie: Supabase — Project Pausing