Collega un progetto Atoms a Supabase quando vuoi che l'app utilizzi un database Supabase, l'autenticazione, l'archiviazione dei file o funzioni backend.

Questa guida ti accompagna nell'intero percorso: preparare un account e un progetto Supabase, autorizzare l'organizzazione corretta, collegare il progetto, verificare che la connessione abbia funzionato e scollegarlo quando necessario.

Come funziona la connessione

Ogni progetto Supabase appartiene a un'organizzazione, che controlla chi può accedere e gestire i progetti al suo interno. Quando colleghi Supabase ad Atoms, prima autorizzi Atoms ad accedere all'organizzazione che vuoi usare, poi selezioni un progetto di quell'organizzazione da collegare.

Ogni progetto Atoms può essere collegato a un solo progetto Supabase alla volta. Tuttavia, lo stesso progetto Supabase può essere collegato a più di un progetto Atoms.

Supabase e Atoms Cloud sono opzioni backend alternative. Non puoi collegarli entrambi allo stesso progetto Atoms contemporaneamente.

Prima di iniziare

Prima di collegare Supabase, assicurati che:

• Tu sia il proprietario dello Spazio di lavoro Atoms che contiene il progetto. Solo il proprietario dello spazio di lavoro può autorizzare, collegare o scollegare Supabase.
• Tu abbia un account Supabase, oppure sia pronto a crearne uno durante la configurazione.
• Tu abbia l'autorizzazione per autorizzare l'organizzazione Supabase e accedere al progetto che vuoi collegare.
• L'Agente abbia terminato l'attività corrente e la Modalità Gara sia disattivata.
• Il tuo browser consenta le finestre pop-up da Atoms.
• Il tuo progetto Atoms non sia già collegato ad Atoms Cloud.

Se stai provando questa connessione per la prima volta, valuta l'uso di un progetto di test mentre impari il processo.

Non incollare mai una password Supabase, una chiave API, un token di accesso o altre credenziali nella Chat.

Connessione Supabase

Apri il connettore Supabase

1. Apri il progetto che vuoi collegare.
2. Fai clic sul nome del progetto, in alto a destra nel pannello della chat.
3. Seleziona Connectors nel menu a discesa che appare.
4. Trova Supabase nell'elenco dei connettori disponibili e fai clic su connect.

Puoi anche aprire Settings → Connectors → Supabase e selezionare Connect.

Apri Settings → Connectors e seleziona Connect per Supabase.

Autorizza Atoms in Supabase

Se Organizations mostra già l'organizzazione Supabase che vuoi usare, significa che è già stata autorizzata. Puoi continuare con Scegli il progetto Supabase.

1. Atoms apre una finestra di autorizzazione Supabase. Accedi all'account Supabase che vuoi collegare oppure crea un nuovo account, se necessario.
2. Verifica di aver effettuato l'accesso all'account Supabase corretto, quindi seleziona l'organizzazione a cui vuoi che Atoms acceda.
3. Controlla le autorizzazioni richieste da Atoms. Per vedere tutte le autorizzazioni, seleziona Show detailed permissions. Se sei d'accordo, seleziona Authorize Atoms.
4. Torna ad Atoms e attendi il messaggio Connect success.
5. In Atoms, apri Connectors → Supabase e conferma che l'organizzazione compaia sotto Organizations.

Atoms richiede accesso in lettura e scrittura a Database, Secrets, Auth, Edge Functions, Environment, Projects, PostgREST e Storage. Richiede anche accesso in lettura a Organizations e Domains. Queste autorizzazioni consentono ad Atoms di collegare e gestire i servizi Supabase supportati usati dal tuo progetto.

Questa autorizzazione si applica all'organizzazione Supabase selezionata e non è limitata al progetto Supabase che collegherai successivamente al progetto Atoms corrente. Atoms non può accedere a organizzazioni o progetti a cui l'account Supabase collegato non può accedere, e le autorizzazioni di Supabase potrebbero imporre ulteriori restrizioni.

Controlla l'organizzazione e le autorizzazioni prima di autorizzare Atoms.

Scegli il progetto Supabase

1. Sotto Organizations, espandi l'organizzazione che hai autorizzato.
2. Sotto Projects, trova il progetto Supabase attivo che vuoi collegare.
3. Se l'organizzazione di cui hai bisogno non è elencata, seleziona New Organization e autorizzala. Questo non crea una nuova organizzazione Supabase; ti consente di autorizzare un'altra organizzazione che esiste già nel tuo account Supabase.
4. Se non hai ancora un progetto, seleziona Create Project e creane uno in Supabase. Attendi finché il progetto non è attivo e pronto all'uso, poi torna ad Atoms e seleziona Update per aggiornare l'elenco dei progetti.
5. Accanto al progetto che vuoi usare, seleziona Connect.

Scegli un progetto Supabase dall'organizzazione autorizzata.

Conferma il progetto

1. Nella finestra di conferma, controlla l'organizzazione e il progetto mostrati sotto Supabase Project.
2. Se necessario, usa Supabase Dashboard o View Tables per confermare di aver selezionato il progetto corretto.
3. Seleziona Connect.
4. Atoms aggiunge un elemento di connessione Supabase alla Chat del progetto. Tieni aperta la pagina e attendi che finisca prima di chiedere all'Agente di creare una funzionalità di database, autenticazione, archiviazione o backend.

Conferma il progetto Supabase selezionato prima di collegarti.

Verifica che la connessione abbia funzionato

1. Apri Settings → Connectors → Supabase.
2. Conferma che l'organizzazione corretta e il progetto Supabase corretto siano mostrati come collegati.
3. Seleziona Dashboard o Tables e verifica che si apra lo stesso progetto in Supabase.

Il pannello del progetto collegato può includere anche link a Manage Users, SQL Editor, Edge Functions e Manage Secrets. Devi usare solo le aree pertinenti alle funzionalità che stai creando.

Controlla il progetto Supabase collegato e i suoi link di gestione.

Verifica che la tua app possa salvare dati

Collegare Supabase non aggiunge di per sé una funzionalità di database alla tua app. In Chat, chiedi all'Agente di creare la funzionalità che desideri e di usare il progetto Supabase collegato per archiviare i suoi dati. Dopo che l'Agente ha finito, testa l'intero percorso.

1. In Chat, descrivi la funzionalità che desideri, quali informazioni deve salvare e dove gli utenti dovrebbero rivedere tali informazioni. Di' all'Agente di usare il progetto Supabase collegato.
2. Attendi che l'Agente finisca di creare la funzionalità.
3. Nel Visualizzatore App, usa la funzionalità come farebbe un utente e inserisci dati di test innocui. Non usare informazioni personali, riservate o sensibili.
4. Aggiorna il Visualizzatore App o riapri la funzionalità. Conferma che le informazioni salvate rimangano e appaiano nel punto corretto.
5. Apri Settings → Connectors → Supabase, seleziona Tables e conferma che il record corrispondente appaia nella tabella corretta.

Se la funzionalità consente agli utenti di modificare o eliminare informazioni salvate, testa anche queste azioni e conferma che i risultati siano corretti sia nell'app sia in Supabase. Il fatto che le modifiche effettuate direttamente in Supabase appaiano immediatamente nell'app dipende da come l'app è stata costruita.

Scollega Supabase

Scollega Supabase quando non vuoi più che il progetto Atoms corrente utilizzi il progetto Supabase collegato.

1. Apri Settings → Connectors → Supabase.
2. Conferma di stare visualizzando la connessione del progetto Atoms corretto.
3. Seleziona Disconnect Project.
4. Attendi che l'elemento di disconnessione Supabase nella Chat finisca.
5. Riapri Connectors → Supabase e conferma che il progetto non sia più mostrato come collegato.

La disconnessione rimuove la connessione dal progetto Atoms corrente. Non elimina il progetto Supabase né i suoi dati e non rimuove l'autorizzazione per l'organizzazione Supabase.

Qualsiasi funzionalità del tuo progetto Atoms che dipenda da Supabase potrebbe smettere di funzionare dopo la disconnessione. Se la tua app è già pubblicata, potresti dover aggiornare la versione pubblicata prima che la modifica abbia effetto. Testa sia il tuo progetto sia l'app live dopo la disconnessione.

Scollegare Supabase da un progetto Atoms non influisce su altri progetti Atoms collegati allo stesso progetto Supabase.

FAQ

Perché la mia connessione Supabase ha smesso di funzionare?

1. Apri il Supabase Dashboard e controlla lo stato del progetto interessato. Un progetto Piano Gratuito con bassa attività può essere messo in pausa dopo un periodo di sette giorni.
2. Se è in pausa, seleziona Resume project e attendi finché Supabase non segnala che è attivo.
3. Torna ad Atoms, apri il pannello Connectors del progetto e verifica la connessione Supabase. Riprova una volta l'azione che non riesce.
4. Se Supabase è già attivo, acquisisci l'errore esatto di Atoms o Supabase e controlla se la connessione è mostrata come disconnessa o scaduta. Ricollega solo quando lo stato indica che è necessario.

Non ruotare le chiavi e non creare un progetto sostitutivo finché non conosci la causa e non hai protetto i dati esistenti. Se il problema continua, contatta il Supporto con il Chat Link, l'ora e il fuso orario, lo stato della connessione e uno screenshot dell'errore ripulito dai dati sensibili.

Riferimento esterno: Supabase — Project Pausing

Come faccio a ricollegare un progetto Supabase che è stato messo in pausa?

1. Accedi all'organizzazione Supabase corretta e apri il progetto in pausa.
2. Seleziona Resume project e attendi finché il suo stato non è attivo. Le indicazioni attuali di Supabase dicono che i progetti Piano Gratuito con bassa attività possono essere messi in pausa dopo un periodo di sette giorni di bassa attività.
3. Torna ad Atoms e apri il pannello Connectors del progetto. Conferma che Supabase sia collegato, quindi riprova l'operazione interessata.
4. Se Atoms mostra ancora il connettore come disconnesso o scaduto, ricollegalo e completa l'autorizzazione richiesta.

Non creare un nuovo progetto Supabase e non ruotare le credenziali finché i dati esistenti non sono protetti. Se la riconnessione non riesce, fornisci al Supporto il Chat Link, lo stato del progetto Supabase, l'ora e il fuso orario, e uno screenshot dell'errore ripulito dai dati sensibili.

Riferimento esterno: Supabase — Project Pausing