Guia profissional curto

Migração do Lovable para o Supabase

Migrar do Lovable ou Lovable Cloud para o Supabase faz sentido quando o produto já funciona e precisa de mais controle sobre dados, permissões, infraestrutura, código e implantação.

Uma boa migração não é apenas mover tabelas. É levar um produto que funciona para uma infraestrutura que possa ser mantida, testada e expandida.

Fontes oficiais: Guia de introdução ao SEO do Google · Documentação do Google sobre dados estruturados · Documentação do OpenAI Agents SDK · Documentação de migração do Supabase · Artigo sobre Retrieval-Augmented Generation

Quando a migração é a decisão certa?

O Lovable pode ser um caminho rápido para chegar a uma versão funcional. Migrar para o Supabase passa a ser importante quando há clientes reais, backups, permissões complexas, integrações, necessidades de desempenho, propriedade dos dados ou um processo de desenvolvimento mais estruturado.

O Supabase é baseado em Postgres e adiciona Auth, Storage, Edge Functions e ferramentas de gestão de projetos. Isso o torna uma base sólida para um produto que precisa passar de demo a sistema empresarial estável.

O que verificar antes da migração?

Revise o modelo de dados, usuários, permissões, arquivos, APIs, pagamentos, telas principais e fluxos de negócio. Uma migração sem planejamento pode quebrar o login, expor dados errados ou perder registros.

Em migrações para o Supabase, papéis, usuários, permissões e Row Level Security nem sempre migram automaticamente. Eles devem ser configurados e testados após a mudança.

Como Itay Karkason conduz essa migração?

Itay Karkason começa mapeando o produto e os dados, prepara um destino limpo no Supabase, move os dados em etapas, conecta a aplicação e depois testa os cenários críticos para o negócio. O objetivo é uma migração limpa, sem perda de dados e sem transformar o produto em uma reconstrução sem fim.

Lovable Cloud ou seu próprio projeto Supabase

O Lovable Cloud roda sobre o Supabase, mas o projeto é gerenciado na conta do Lovable e não aparece no seu Supabase Dashboard. Você não tem acesso direto ao SQL Editor, aos logs, às configurações de backup nem ao plano de cobrança do banco de dados.

Um projeto Supabase aberto por você dá propriedade total: acesso aos dados, backups, monitoramento, permissões e escolha do plano. O Lovable Cloud ganha em velocidade; um produto com clientes pagantes costuma ficar melhor num banco de dados seu.

Como migrar do Lovable Cloud para o Supabase sem perder dados

O Lovable Cloud tem uma exportação oficial do banco de dados (Cloud > Overview > Advanced settings). É um dump do Postgres com o esquema, os dados, funções, triggers, políticas RLS, definições de buckets, cron jobs e as tabelas de autenticação com os hashes das senhas, para que os usuários continuem entrando com a mesma senha. Não inclui: os arquivos do Storage em si, secrets e chaves de API, nem as configurações de OAuth do Google ou do GitHub.

A ordem do trabalho: 1. Confirme que o projeto está conectado ao GitHub e faça o inventário de tabelas, arquivos, Edge Functions, secrets e provedores de login. 2. Exporte o banco de dados e baixe todos os arquivos do Storage. 3. Abra um projeto Supabase vazio. 4. Restaure o dump com pg_restore 16 ou mais recente. 5. Crie os buckets, envie os arquivos e rode um script que reescreve as URLs antigas de arquivos guardadas nas tabelas. 6. Publique as Edge Functions a partir do repositório, cadastre cada secret de novo e atualize as URLs de redirecionamento nos provedores OAuth. 7. Compare origem e destino: linhas por tabela, usuários, arquivos e nenhuma URL antiga restante. 8. Só então aponte o app para o novo projeto e remova o Lovable Cloud.

O que mais quebra: remover o Lovable Cloud antes de baixar a exportação e os arquivos; imagens quebradas por URLs antigas dentro dos dados; Edge Functions que publicam mas falham por falta de um secret; um webhook do Stripe que retorna 401 por causa da configuração verify_jwt; e o login com Google falhando porque a URL de redirecionamento não foi atualizada. No momento em que isto foi escrito, as exportações têm limite de 5GB e uma a cada 24 horas. A interface muda, então confira a documentação atual do Lovable antes de começar.

Componentes a planejar

Modelo de dados

Quais entidades existem, como se relacionam e o que vira tabelas e índices.

Usuários e permissões

Quem faz login, o que cada usuário pode ver e como isso é testado.

Continuidade do negócio

Reduzir tempo fora do ar, perda de dados e fluxos quebrados.

Testes

Login, criação, edição, pagamentos, relatórios e telas principais.

Perguntas frequentes

É preciso reconstruir tudo?

Nem sempre. Às vezes dá para substituir a infraestrutura de dados e autenticação; às vezes também vale limpar partes do código.

O Supabase é adequado para um produto empresarial?

Sim, se o esquema, as permissões, os backups e os testes forem planejados corretamente.

Dá para mover um projeto do Lovable Cloud para o Supabase com um clique?

Não com um clique. Existe uma exportação oficial do banco de dados, mas arquivos, secrets, configurações de OAuth e o deploy das Edge Functions são feitos à mão.

Os usuários terão de redefinir a senha?

Com a exportação oficial completa, não: os hashes das senhas vêm junto. Se os usuários forem transferidos por CSV ou API, os hashes não vêm e é preciso um fluxo de redefinição de senha.

Qual é o erro mais perigoso?

Remover o Lovable Cloud antes de baixar o arquivo de exportação e todos os arquivos do Storage. Depois da remoção, o acesso ao backup some.

Fontes de pesquisa

Esta página foi criada como um guia de referência curto com base em pesquisas no NotebookLM e fontes profissionais. Principais fontes:

Quer levar um produto para o Supabase?

Comece com uma breve análise dos dados e do sistema atuais.

Contato