Conecte um projeto do Atoms ao Supabase quando quiser que o app use um banco de dados do Supabase, autenticação, armazenamento de arquivos ou funções de backend.

Este guia leva você por toda a jornada completa: preparar uma conta e um projeto no Supabase, autorizar a organização correta, conectar o projeto, verificar se a conexão funcionou e desconectá-lo quando necessário.

Como a conexão funciona

Cada projeto do Supabase pertence a uma organização, que controla quem pode acessar e gerenciar os projetos dentro dela. Quando você conecta o Supabase ao Atoms, primeiro autoriza o Atoms a acessar a organização que deseja usar e, em seguida, seleciona um projeto dessa organização para conectar.

Cada projeto do Atoms pode ser conectado a um projeto do Supabase por vez. No entanto, o mesmo projeto do Supabase pode ser conectado a mais de um projeto do Atoms.

Supabase e Atoms Cloud são opções alternativas de backend. Você não pode conectar ambos ao mesmo projeto do Atoms ao mesmo tempo.

Antes de começar

Antes de conectar o Supabase, certifique-se de que:

• Você é o proprietário do espaço de trabalho do Atoms que contém o projeto. Somente o proprietário do espaço de trabalho pode autorizar, conectar ou desconectar o Supabase.
• Você tem uma conta no Supabase ou está pronto para criar uma durante a configuração.
• Você tem permissão para autorizar a organização do Supabase e acessar o projeto com o qual deseja se conectar.
• O Agente terminou sua tarefa atual e o Modo Corrida está desativado.
• Seu navegador permite janelas pop-up do Atoms.
• Seu projeto do Atoms ainda não está conectado ao Atoms Cloud.

Se você estiver tentando essa conexão pela primeira vez, considere usar um projeto de teste enquanto aprende o processo.

Nunca cole uma senha do Supabase, chave de API, token de acesso ou outra credencial no Chat.

Conectar Supabase

Abra o conector do Supabase

1. Abra o projeto que deseja conectar.
2. Clique no nome do projeto, no canto superior direito do painel de chat.
3. Selecione Connectors no menu suspenso que aparece.
4. Encontre Supabase na lista de conectores disponíveis e clique em connect.

Você também pode abrir Settings → Connectors → Supabase e selecionar Connect.

Abra Settings → Connectors e selecione Connect para Supabase.

Autorizar o Atoms no Supabase

Se Organizations já mostrar a organização do Supabase que você deseja usar, ela já foi autorizada. Você pode continuar em Escolher o projeto do Supabase.

1. O Atoms abre uma janela de autorização do Supabase. Entre na conta do Supabase à qual deseja se conectar ou crie uma nova conta, se necessário.
2. Verifique se você entrou na conta correta do Supabase e, em seguida, selecione a organização à qual deseja que o Atoms acesse.
3. Revise as permissões solicitadas pelo Atoms. Para ver todas as permissões, selecione Show detailed permissions. Se concordar, selecione Authorize Atoms.
4. Volte ao Atoms e aguarde a mensagem Connect success.
5. No Atoms, abra Connectors → Supabase e confirme que a organização aparece em Organizations.

O Atoms solicita acesso de leitura e gravação a Banco de Dados, Secrets, Auth, Edge Functions, Environment, Projects, PostgREST e Storage. Ele também solicita acesso de leitura a Organizations e Domains. Essas permissões permitem que o Atoms conecte e gerencie os serviços compatíveis do Supabase usados pelo seu projeto.

Esta autorização se aplica à organização do Supabase selecionada e não se limita ao projeto do Supabase que você conectar depois ao projeto atual do Atoms. O Atoms não pode acessar organizações ou projetos aos quais a própria conta conectada do Supabase não pode acessar, e as permissões do Supabase podem impor restrições adicionais.

Revise a organização e as permissões antes de autorizar o Atoms.

Escolher o projeto do Supabase

1. Em Organizations, expanda a organização que você autorizou.
2. Em Projects, encontre o projeto ativo do Supabase que deseja conectar.
3. Se a organização de que você precisa não estiver listada, selecione New Organization e autorize-a. Isso não cria uma nova organização no Supabase; isso permite que você autorize outra organização que já existe na sua conta do Supabase.
4. Se você ainda não tiver um projeto, selecione Create Project e crie um no Supabase. Aguarde até que o projeto esteja ativo e pronto para uso, depois volte ao Atoms e selecione Update para atualizar a lista de projetos.
5. Ao lado do projeto que deseja usar, selecione Connect.

Escolha um projeto do Supabase na organização autorizada.

Confirmar o projeto

1. Na janela de confirmação, verifique a organização e o projeto mostrados em Supabase Project.
2. Se necessário, use Supabase Dashboard ou View Tables para confirmar que você selecionou o projeto correto.
3. Selecione Connect.
4. O Atoms adiciona um item de conexão do Supabase ao Chat do projeto. Mantenha a página aberta e aguarde a conclusão antes de pedir ao Agente para criar um recurso de banco de dados, autenticação, armazenamento ou backend.

Confirme o projeto do Supabase selecionado antes de conectar.

Verifique se a conexão funcionou

1. Abra Settings → Connectors → Supabase.
2. Confirme que a organização correta e o projeto correto do Supabase são mostrados como conectados.
3. Selecione Dashboard ou Tables e verifique se isso abre o mesmo projeto no Supabase.

O painel do projeto conectado também pode incluir links para Manage Users, SQL Editor, Edge Functions e Manage Secrets. Você só precisa usar as áreas relevantes para os recursos que está criando.

Revise o projeto do Supabase conectado e seus links de gerenciamento.

Teste se seu app consegue salvar dados

Conectar o Supabase não adiciona, por si só, um recurso de banco de dados ao seu app. No Chat, peça ao Agente para criar o recurso que você deseja e usar o projeto do Supabase conectado para armazenar os dados dele. Depois que o Agente terminar, teste toda a jornada completa.

1. No Chat, descreva o recurso que você deseja, quais informações ele deve salvar e onde os usuários devem ver essas informações novamente. Diga ao Agente para usar o projeto do Supabase conectado.
2. Aguarde o Agente terminar de criar o recurso.
3. No Visualizador de App, use o recurso como um usuário usaria e insira dados de teste inofensivos. Não use informações pessoais, confidenciais ou sensíveis.
4. Atualize o Visualizador de App ou reabra o recurso. Confirme que as informações salvas permanecem e aparecem no lugar correto.
5. Abra Settings → Connectors → Supabase, selecione Tables e confirme que o registro correspondente aparece na tabela correta.

Se o recurso permitir que os usuários editem ou excluam informações salvas, teste essas ações também e confirme que os resultados estão corretos tanto no app quanto no Supabase. Se alterações feitas diretamente no Supabase aparecem imediatamente no app depende de como o app foi criado.

Desconectar Supabase

Desconecte o Supabase quando não quiser mais que o projeto atual do Atoms use o projeto conectado do Supabase.

1. Abra Settings → Connectors → Supabase.
2. Confirme que você está visualizando a conexão do projeto correto do Atoms.
3. Selecione Disconnect Project.
4. Aguarde a conclusão do item de desconexão do Supabase no Chat.
5. Reabra Connectors → Supabase e confirme que o projeto não é mais mostrado como conectado.

Desconectar remove a conexão do projeto atual do Atoms. Isso não exclui o projeto do Supabase nem seus dados e não remove a autorização da organização do Supabase.

Quaisquer recursos no seu projeto do Atoms que dependam do Supabase podem parar de funcionar depois que você o desconectar. Se seu app já estiver publicado, talvez seja necessário atualizar a versão publicada antes que a mudança entre em vigor. Teste tanto seu projeto quanto o app ao vivo após desconectar.

Desconectar o Supabase de um projeto do Atoms não afeta outros projetos do Atoms conectados ao mesmo projeto do Supabase.

FAQ

Por que minha conexão com o Supabase parou de funcionar?

1. Abra o Supabase Dashboard e verifique o status do projeto afetado. Um projeto do Plano Gratuito com baixa atividade pode ser pausado após um período de sete dias.
2. Se ele estiver pausado, selecione Resume project e aguarde até que o Supabase informe que ele está ativo.
3. Volte ao Atoms, abra o painel Connectors do projeto e verifique a conexão com o Supabase. Tente novamente a ação que falhou uma vez.
4. Se o Supabase já estiver ativo, capture o erro exato do Atoms ou do Supabase e verifique se a conexão é mostrada como desconectada ou expirada. Reconecte somente quando o status indicar que isso é necessário.

Não altere chaves nem crie um projeto substituto até saber a causa e ter protegido os dados existentes. Se a falha continuar, entre em contato com o Suporte com o Chat Link, horário e fuso horário, status da conexão e captura de tela do erro com dados sensíveis removidos.

Referência externa: Supabase — Project Pausing

Como reconecto um projeto do Supabase que foi pausado?

1. Entre na organização correta do Supabase e abra o projeto pausado.
2. Selecione Resume project e aguarde até que o status fique ativo. A orientação atual do Supabase diz que projetos do Plano Gratuito com baixa atividade podem ser pausados após um período de sete dias de baixa atividade.
3. Volte ao Atoms e abra o painel Connectors do projeto. Confirme que o Supabase está conectado e tente novamente a operação afetada.
4. Se o Atoms ainda mostrar o conector como desconectado ou expirado, reconecte-o e conclua a autorização solicitada.

Não crie um novo projeto do Supabase nem altere credenciais até que os dados existentes estejam protegidos. Se a reconexão falhar, forneça ao Suporte o Chat Link, o status do projeto no Supabase, horário e fuso horário, e uma captura de tela do erro com dados sensíveis removidos.

Referência externa: Supabase — Project Pausing