Anslut ett Atoms-projekt till Supabase när du vill att appen ska använda en Supabase-databas, autentisering, fillagring eller backendfunktioner.

Den här guiden tar dig genom hela processen: förbered ett Supabase-konto och projekt, auktorisera rätt organisation, anslut projektet, kontrollera att anslutningen fungerade och koppla från det vid behov.

Så fungerar anslutningen

Varje Supabase-projekt tillhör en organisation, som styr vem som kan få åtkomst till och hantera projekten inom den. När du ansluter Supabase till Atoms auktoriserar du först Atoms att få åtkomst till den organisation du vill använda och väljer sedan ett projekt från den organisationen att ansluta.

Varje Atoms-projekt kan vara anslutet till ett Supabase-projekt åt gången. Däremot kan samma Supabase-projekt vara anslutet till mer än ett Atoms-projekt.

Supabase och Atoms moln är alternativa backendalternativ. Du kan inte ansluta båda till samma Atoms-projekt samtidigt.

Innan du börjar

Innan du ansluter Supabase, se till att:

• Du är ägare till Atoms-arbetsytan som innehåller projektet. Endast arbetsytans ägare kan auktorisera, ansluta eller koppla från Supabase.
• Du har ett Supabase-konto eller är redo att skapa ett under konfigurationen.
• Du har behörighet att auktorisera Supabase-organisationen och få åtkomst till projektet som du vill ansluta till.
• Agent har slutfört sin aktuella uppgift och Race Mode är avstängt.
• Din webbläsare tillåter popup-fönster från Atoms.
• Ditt Atoms-projekt är inte redan anslutet till Atoms moln.

Om du provar den här anslutningen för första gången kan det vara bra att använda ett testprojekt medan du lär dig processen.

Klistra aldrig in ett Supabase-lösenord, en API-nyckel, en åtkomsttoken eller någon annan autentiseringsuppgift i Chat.

Anslut Supabase

Öppna Supabase-anslutningen

1. Öppna projektet som du vill ansluta.
2. Klicka på projektnamnet högst upp till höger i chattpanelen.
3. Välj Connectors i rullgardinsmenyn som visas.
4. Hitta Supabase i listan över tillgängliga anslutningar och klicka på connect.

Du kan också öppna Settings → Connectors → Supabase och välja Connect.

Öppna Settings → Connectors och välj Connect för Supabase.

Auktorisera Atoms i Supabase

Om Organizations redan visar den Supabase-organisation som du vill använda, har den redan auktoriserats. Du kan fortsätta till Välj Supabase-projektet.

1. Atoms öppnar ett auktoriseringsfönster för Supabase. Logga in på det Supabase-konto som du vill ansluta till, eller skapa ett nytt konto vid behov.
2. Kontrollera att du är inloggad på rätt Supabase-konto och välj sedan den organisation som du vill att Atoms ska få åtkomst till.
3. Granska behörigheterna som Atoms begär. För att se alla behörigheter, välj Show detailed permissions. Om du godkänner, välj Authorize Atoms.
4. Gå tillbaka till Atoms och vänta på meddelandet Connect success.
5. I Atoms öppnar du Connectors → Supabase och bekräftar att organisationen visas under Organizations.

Atoms begär läs- och skrivåtkomst till Database, Secrets, Auth, Edge Functions, Environment, Projects, PostgREST och Storage. Det begär också läsåtkomst till Organizations och Domains. Dessa behörigheter gör att Atoms kan ansluta och hantera de Supabase-tjänster som stöds och används av ditt projekt.

Den här auktoriseringen gäller för den valda Supabase-organisationen och är inte begränsad till det Supabase-projekt som du senare ansluter till det aktuella Atoms-projektet. Atoms kan inte få åtkomst till organisationer eller projekt som det anslutna Supabase-kontot självt inte kan få åtkomst till, och Supabase-behörigheter kan medföra ytterligare begränsningar.

Granska organisationen och behörigheterna innan du auktoriserar Atoms.

Välj Supabase-projektet

1. Under Organizations expanderar du den organisation som du auktoriserade.
2. Under Projects hittar du det aktiva Supabase-projekt som du vill ansluta.
3. Om organisationen som du behöver inte finns med i listan, välj New Organization och auktorisera den. Detta skapar inte en ny Supabase-organisation; det låter dig auktorisera en annan organisation som redan finns i ditt Supabase-konto.
4. Om du ännu inte har något projekt, välj Create Project och skapa ett i Supabase. Vänta tills projektet är aktivt och klart att använda, gå sedan tillbaka till Atoms och välj Update för att uppdatera projektlistan.
5. Bredvid projektet som du vill använda väljer du Connect.

Välj ett Supabase-projekt från den auktoriserade organisationen.

Bekräfta projektet

1. I bekräftelsefönstret kontrollerar du organisationen och projektet som visas under Supabase Project.
2. Om det behövs använder du Supabase Dashboard eller View Tables för att bekräfta att du valde rätt projekt.
3. Välj Connect.
4. Atoms lägger till ett Supabase-anslutningsobjekt i projektets Chat. Låt sidan vara öppen och vänta tills det är klart innan du ber Agent att bygga en databas-, autentiserings-, lagrings- eller backendfunktion.

Bekräfta det valda Supabase-projektet innan du ansluter.

Kontrollera att anslutningen fungerade

1. Öppna Settings → Connectors → Supabase.
2. Bekräfta att rätt organisation och Supabase-projekt visas som anslutna.
3. Välj Dashboard eller Tables och kontrollera att det öppnar samma projekt i Supabase.

Panelen för det anslutna projektet kan också innehålla länkar till Manage Users, SQL Editor, Edge Functions och Manage Secrets. Du behöver bara använda de områden som är relevanta för funktionerna som du bygger.

Granska det anslutna Supabase-projektet och dess hanteringslänkar.

Testa att din app kan spara data

Att ansluta Supabase lägger inte till en databasfunktion i din app i sig. I Chat ber du Agent att bygga den funktion du vill ha och använda det anslutna Supabase-projektet för att lagra dess data. När Agent har slutfört arbetet testar du hela flödet.

1. I Chat beskriver du funktionen du vill ha, vilken information den ska spara och var användare ska kunna se informationen igen. Tala om för Agent att använda det anslutna Supabase-projektet.
2. Vänta tills Agent har byggt klart funktionen.
3. I App Viewer använder du funktionen som en användare skulle göra och anger ofarliga testdata. Använd inte personlig, konfidentiell eller känslig information.
4. Uppdatera App Viewer eller öppna funktionen igen. Bekräfta att den sparade informationen finns kvar och visas på rätt plats.
5. Öppna Settings → Connectors → Supabase, välj Tables och bekräfta att motsvarande post visas i rätt tabell.

Om funktionen låter användare redigera eller ta bort sparad information, testa även dessa åtgärder och bekräfta att resultaten är korrekta både i appen och i Supabase. Om ändringar som görs direkt i Supabase visas omedelbart i appen beror på hur appen byggdes.

Koppla från Supabase

Koppla från Supabase när du inte längre vill att det aktuella Atoms-projektet ska använda det anslutna Supabase-projektet.

1. Öppna Settings → Connectors → Supabase.
2. Bekräfta att du visar anslutningen för rätt Atoms-projekt.
3. Välj Disconnect Project.
4. Vänta tills frånkopplingsobjektet för Supabase i Chat är klart.
5. Öppna Connectors → Supabase igen och bekräfta att projektet inte längre visas som anslutet.

Att koppla från tar bort anslutningen från det aktuella Atoms-projektet. Det tar inte bort Supabase-projektet eller dess data, och det tar inte bort auktoriseringen för Supabase-organisationen.

Funktioner i ditt Atoms-projekt som är beroende av Supabase kan sluta fungera efter att du kopplar från det. Om din app redan är publicerad kan du behöva uppdatera den publicerade versionen innan ändringen träder i kraft. Testa både ditt projekt och liveappen efter frånkopplingen.

Att koppla från Supabase från ett Atoms-projekt påverkar inte andra Atoms-projekt som är anslutna till samma Supabase-projekt.

Vanliga frågor

Varför har min Supabase-anslutning slutat fungera?

1. Öppna Supabase Dashboard och kontrollera statusen för det berörda projektet. Ett Free Plan-projekt med låg aktivitet kan pausas efter en period på sju dagar.
2. Om det är pausat, välj Resume project och vänta tills Supabase rapporterar att det är aktivt.
3. Gå tillbaka till Atoms, öppna projektets Connectors-panel och verifiera Supabase-anslutningen. Försök med den misslyckade åtgärden en gång till.
4. Om Supabase redan är aktivt, dokumentera det exakta Atoms- eller Supabase-felet och kontrollera om anslutningen visas som frånkopplad eller utgången. Återanslut bara när statusen visar att det behövs.

Rotera inte nycklar och skapa inte ett ersättningsprojekt förrän du känner till orsaken och har skyddat befintliga data. Om felet kvarstår, kontakta Support med Chat Link, tid och tidszon, anslutningsstatus och en rensad skärmbild av felet.

Extern referens: Supabase — Project Pausing

Hur återansluter jag ett Supabase-projekt som har pausats?

1. Logga in i rätt Supabase-organisation och öppna det pausade projektet.
2. Välj Resume project och vänta tills dess status är aktiv. Enligt aktuell vägledning från Supabase kan Free Plan-projekt med låg aktivitet pausas efter en period på sju dagar med låg aktivitet.
3. Gå tillbaka till Atoms och öppna projektets Connectors-panel. Bekräfta att Supabase är anslutet och försök sedan med den berörda åtgärden igen.
4. Om Atoms fortfarande visar anslutningen som frånkopplad eller utgången, återanslut den och slutför den begärda auktoriseringen.

Skapa inte ett nytt Supabase-projekt och rotera inte autentiseringsuppgifter förrän befintliga data är skyddade. Om återanslutningen misslyckas, ge Support Chat Link, Supabase-projektets status, tid och tidszon samt en rensad skärmbild av felet.

Extern referens: Supabase — Project Pausing