Supabase do zero: conta, projeto seguro, chaves e o dia a dia do banco

Para que serve no AFK

Banco de dados online para o site, o app ou o sistema que você criar com o AFK: cadastro, área de cliente, formulário que grava, login de usuários e arquivos.

Os dados do dia a dia do AFK, como clientes, agenda e financeiro, ficam no seu PC e não precisam do Supabase.

Antes: grátis ou Pro

O Pro vem com teto de gasto ligado: passou da cota, ele limita em vez de cobrar extra. Para site de negócio que precisa ficar no ar sempre, o Pro evita a pausa. Preço atual: supabase.com/pricing.

Parte 1: criar a conta e a organização

O site do Supabase é em inglês. Os nomes dos botões abaixo estão como aparecem na tela.

1. Abra supabase.com/dashboard e entre com Continue with GitHub (veja GitHub do zero: conta, 2FA, repositório privado, login e token).
2. Na primeira vez, ele pede a organização, que é o grupo dos seus projetos e onde fica a cobrança. Em Name, ponha o nome da empresa. Em Plan, escolha Free para começar. Clique em Create organization.

   

3. Ligue a verificação em duas etapas: abra supabase.com/dashboard/account/security e cadastre o app autenticador. O Supabase não tem códigos de recuperação: cadastre um segundo autenticador (outro celular ou o gerenciador de senhas). Sem nenhum dos dois, eles não devolvem a conta.

Parte 2: criar o projeto do jeito seguro

1. Clique em New project e preencha:
   • Project name: o nome do app, por exemplo meu-app.
   • Database password: clique em Generate a password e guarde no gerenciador de senhas. É a senha do banco inteiro.
   • Region: clique em Need a specific region? e escolha South America (São Paulo). Os seus clientes estão no Brasil, e assim o banco responde mais rápido.
   • Security:
     • deixe Enable Data API ligado (é por ele que o site conversa com o banco);
     • desligue Automatically expose new tables, como o próprio Supabase recomenda;
     • ligue Enable automatic RLS, que põe a trava de acesso em toda tabela nova.

   

2. Clique em Create new project e espere uns 2 minutos até ele ficar pronto.

Por que a trava (RLS) importa: sem ela, qualquer pessoa com o endereço do seu site consegue ler a tabela inteira. Com RLS, cada tabela só entrega o que uma regra permite, por exemplo "cada cliente vê só os pedidos dele". Quando o AFK montar as tabelas, ele escreve essas regras. Peça: "cria a tabela com RLS e me explica quem vê o quê".

Parte 3: pegar a URL e a chave secreta e colar no AFK

1. A chave secreta: abra supabase.com/dashboard/project/_/settings/api-keys e escolha o projeto. Você cai em API Keys, na aba Publishable and secret API keys.
   • Na seção Secret keys, clique em New secret key, dê o nome afk e crie. Se já existir uma, clique no ícone de olho para mostrar e no de copiar para copiar.
   • Não use a Publishable key (sb_publishable_) aqui. Ela é a do site público: pode aparecer no navegador e só faz o que o RLS deixa.

   

2. A URL do projeto: no menu da esquerda, abra Integrations → Data API. Em API URL, copie o endereço só até .supabase.co, sem o /rest/v1/ do fim. Fica assim: https://abcdefghijklmnopqrst.supabase.co.

   

3. No painel do AFK, abra Conexões e clique no cartão Supabase (banco na nuvem). Cole a URL em Project URL e a chave em Chave secreta. Clique em Salvar conexão e depois em Testar.

Cuidado com a chave secreta

Ela passa por cima de todas as travas (RLS): quem tem a chave lê e apaga tudo.

• Ela fica só no .env do seu computador ou nas variáveis do servidor (por exemplo, Environment Variables da Vercel).
• Nunca coloque em site, app de celular, arquivo público ou print. O próprio Supabase avisa: use só em servidor.
• Vazou? Em API Keys, apague a chave (menu ⋮ da linha) e crie outra.

Projeto antigo, só com "Legacy": se o projeto só tem a aba Legacy anon, service_role API keys, a service_role faz o papel da secreta e a anon faz o da publishable. As duas ainda funcionam, mas o Supabase vai desligar as antigas: crie as novas na mesma página.

Parte 4: pelo terminal (o que o AFK usa)

O AFK usa a CLI oficial para criar e mudar tabelas com histórico. Para conferir ou fazer na mão:

1. Instale (na pasta do projeto, precisa do Node.js):

   npm install supabase --save-dev

   No Mac, também dá para usar brew install supabase/tap/supabase.

2. Entre: npx supabase login. Abre o navegador para confirmar a conta.
3. Ligue a pasta ao projeto: npx supabase link. Escolha o projeto na lista.
4. Mudanças no banco viram arquivo: npx supabase migration new criar_clientes cria o arquivo da mudança. npx supabase db push aplica no projeto online. Assim, toda mudança fica guardada no GitHub e dá para refazer o banco do zero.
5. Cópia de segurança no grátis: npx supabase db dump -f backup.sql salva o banco num arquivo. Peça ao AFK para fazer isso de tempos em tempos.

No dia a dia

Erros e soluções

Se nada funcionar

Veja Travou ou quero sugerir uma melhoria: o que mandar. Mande o texto do erro. Nunca mande a chave nem a senha do banco.

Fontes oficiais (conferido em 30/10/2026): supabase.com/pricing (Free: 2 projetos, 500 MB, pausa após 1 semana; Pro a partir de US$ 25 com teto de gasto ligado) · supabase.com/docs/guides/api/api-keys · supabase.com/docs/guides/platform/multi-factor-authentication (sem códigos de recuperação) · supabase.com/docs/guides/platform/backups (grátis sem backup automático; Pro 7 dias) · supabase.com/docs/guides/local-development/cli/getting-started · supabase.com/docs/guides/deployment/database-migrations · supabase.com/dashboard (formulário de organização e de projeto, no dia).