Tive meu projeto bloqueado, e agora? Como recuperar seu projeto no Lovable

O processo é simples 🚀

Abrir o Lovable e descobrir que não dá mais para editar um projeto assusta, principalmente quando ele já está no ar. A boa notícia: se o código está no GitHub e o banco está em um Supabase seu, o projeto não se perdeu. Você só precisa levá-lo para um projeto novo e continuar de onde parou.

Este guia mostra o caminho completo: o que separar antes de começar, como enviar tudo para o Lovable e como deixar o projeto mais protegido daqui para frente, com a estrutura GitHub → Supabase → Vercel.

Primeiro: descubra em qual caso o seu projeto está

Existem dois caminhos, e a diferença está em onde fica o banco de dados do projeto:

Na dúvida, faça este teste: entre na sua conta do Supabase. Se o projeto aparece lá, porque foi você quem criou e conectou ao Lovable, o Supabase é externo (caso a). Se o banco foi criado automaticamente pelo Lovable e não aparece na sua conta, ele está no Lovable Cloud (caso b).

Caminho (b): projeto no Lovable Cloud? Migre antes com o CloneSupa

⚠️ Observação: se o projeto ainda estiver no Lovable Cloud, use o CloneSupa para migrar para um Supabase externo antes de seguir o processo deste guia.

O Lovable Cloud é o backend integrado do Lovable: o banco, a autenticação e o armazenamento ficam dentro da plataforma. É prático para começar, mas o banco não fica na sua conta. A própria documentação do Lovable (abre em nova aba) informa que não existe migração de um clique do Cloud para um Supabase próprio.

É esse o papel do CloneSupa: ele clona o projeto do Lovable Cloud direto para o seu Supabase. O roteiro é este:

1. Crie um projeto novo no Supabase, na sua própria conta. Ele vai receber o banco.
2. Instale o CloneSupa e ative com a chave de licença recebida na compra.
3. Rode a migração do projeto do Lovable Cloud para o Supabase que você acabou de criar.
4. Confira os dados no painel do Supabase: tabelas, usuários e arquivos.

Pronto: a partir daqui, o seu projeto está no caso (a). Siga o restante do guia normalmente.

O que separar antes de migrar

Com o banco já em um Supabase externo, separe tudo o que é necessário para migrar e continuar editando. Use a lista abaixo como checklist:

• Arquivo .ZIP do projeto, com todo o código.
• Download (backup) do projeto pelo GitHub, guardado no seu computador.
• Repositório conectado ao GitHub, na sua conta.
• Dados do Supabase externo:
  • Project URL;
  • Access Token;
  • Anon Key;
  • Service Role Key.

Como baixar o .ZIP e fazer o backup pelo GitHub

Se o projeto estava conectado ao GitHub, todo o código está no repositório, mesmo sem acesso ao Lovable:

1. Abra o repositório do projeto no GitHub.
2. Clique no botão verde Code.
3. Escolha Download ZIP. O arquivo baixado é o .ZIP do projeto e também serve de backup.
4. Guarde uma cópia em um lugar seguro, fora da pasta de downloads.

Onde encontrar cada dado do Supabase

Todos os dados ficam no painel do Supabase, no projeto que guarda o banco do seu app:

Nos projetos mais recentes, o Supabase está trocando os nomes: a Anon Key passa a se chamar publishable key e a Service Role Key, secret key. Segundo a documentação do Supabase (abre em nova aba), as chaves antigas devem ser descontinuadas até o fim de 2026. Se o seu painel mostrar os nomes novos, use a publishable no lugar da Anon e a secret no lugar da Service Role.

Passo a passo: recuperar o projeto no Lovable

Com tudo em mãos, a recuperação leva poucos minutos:

1. Abra um novo chat no Lovable, ou seja, um projeto novo, na conta ou no workspace onde você vai continuar trabalhando.
2. Envie o projeto: anexe o arquivo .ZIP ou indique o repositório do GitHub.
3. Passe os dados do Supabase: Project URL, Access Token, Anon Key e Service Role Key.
4. Peça para o Lovable conectar o projeto ao seu Supabase externo e manter a estrutura, as telas e o banco do jeito que estavam.
5. Conecte o novo projeto ao GitHub, para que as próximas alterações também fiquem salvas no seu repositório.
6. Teste o essencial: login, cadastro, telas principais e qualquer função que grave dados.

Um exemplo de mensagem para o primeiro chat. Troque o texto entre colchetes pelos seus dados e nunca publique essa mensagem em outro lugar:

Este é o meu projeto (arquivo .ZIP em anexo). Quero continuar editando
este mesmo app, sem mudar o layout nem as funcionalidades.

Conecte o projeto ao meu Supabase externo:
- Project URL: [sua Project URL]
- Access Token: [seu Access Token]
- Anon Key: [sua Anon Key]
- Service Role Key: [sua Service Role Key]

Use a Service Role Key só no backend (funções e segredos do Supabase),
nunca no código do frontend.

A partir daí, o projeto fica pronto para continuar as edições normalmente. ✅

🔐 Segurança: cuidado com a Service Role Key

A Service Role Key é uma credencial sensível. Ela ignora as regras de segurança do banco (RLS) e dá acesso total aos dados do projeto. Nunca publique essa chave em repositórios, no código do frontend nem em locais públicos.

Regras práticas para não ter dor de cabeça:

• Frontend só com a chave pública. No código que roda no navegador, use apenas a Project URL e a Anon Key (ou publishable key).
• Service Role só no backend. Ela pode ficar nos segredos das funções do Supabase, nunca em variáveis que comecem com VITE_, porque essas vão parar no navegador de quem visita o site.
• Fora do Git. Não envie arquivos .env com chaves secretas para o GitHub, nem em repositório privado.
• Vazou? Troque. Se a chave apareceu em um print, em um repositório ou em uma conversa pública, gere uma nova no painel do Supabase e desative a antiga.
• Access Token com prazo. Terminada a migração, revogue o Access Token se não for mais usar.

Estrutura recomendada: GitHub → Supabase → Vercel

Para não depender de um só lugar, separe as peças do projeto:

• GitHub guarda o código. É o seu backup permanente e o ponto de partida de qualquer recuperação.
• Supabase guarda os dados. Banco, usuários e arquivos ficam na sua conta, independentemente da ferramenta que você usa para editar.
• Vercel publica o site. O app fica no ar a partir do GitHub, mesmo que algo aconteça com o projeto no Lovable.

O Lovable continua sendo onde você constrói e edita. A diferença é que, com essa estrutura, perder o acesso a um projeto vira um contratempo de minutos, não a perda do seu trabalho.

Outras recomendações: suba o seu projeto na Vercel

Publicar pela Vercel é o passo que completa a proteção. As vantagens:

• O site não depende do Lovable para ficar no ar. Se o projeto for bloqueado de novo, o app continua funcionando.
• Publicação automática. Cada alteração enviada ao GitHub, inclusive as feitas pelo Lovable, gera uma nova versão do site.
• Domínio próprio e HTTPS configurados em poucos cliques.
• Volta rápida. Se uma versão nova der problema, dá para voltar para a anterior pelo painel.

Como fazer, em poucos passos:

1. Crie uma conta na Vercel entrando com o seu GitHub.
2. Clique em Add New → Project e importe o repositório do projeto.
3. Confira a configuração. Projetos do Lovable usam Vite, e a Vercel costuma detectar isso sozinha (comando de build npm run build e pasta de saída dist).
4. Cadastre as variáveis de ambiente, se o projeto usa um arquivo .env: só a URL do Supabase e a chave pública. A Service Role Key não entra aqui.
5. Clique em Deploy e teste o endereço gerado.
6. Conecte o seu domínio, se tiver um, em Settings → Domains.

Uma dica para apps com várias páginas: se ao abrir um link direto (por exemplo, /login) aparecer erro 404, crie um arquivo vercel.json na raiz do projeto com este conteúdo e publique de novo:

{ "rewrites": [{ "source": "/(.*)", "destination": "/index.html" }] }

Checklist final

Antes de considerar o projeto recuperado, confira:

• Banco no Supabase externo (migrado com o CloneSupa, se estava no Lovable Cloud).
• Backup .ZIP guardado e repositório atualizado no GitHub.
• Projeto novo no Lovable conectado ao Supabase e ao GitHub.
• Login, cadastro e telas principais testados.
• Service Role Key fora do frontend e fora do repositório.
• Access Token revogado, se não for mais usar.
• Site publicado na Vercel, com domínio próprio, se tiver.

Conclusão

Ter um projeto bloqueado no Lovable não precisa significar começar do zero. Se o código está no GitHub e o banco em um Supabase seu, basta separar o .ZIP, o backup e os dados do Supabase, abrir um novo chat no Lovable e enviar tudo. Se o projeto ainda está no Lovable Cloud, o primeiro passo é migrar com o CloneSupa.

Depois de recuperar, adote a estrutura GitHub → Supabase → Vercel e trate a Service Role Key como uma senha. Para entender como organizar contas, funções e projetos, veja o guia sobre o Lovable Workspace e, se precisar de mais créditos para continuar editando, o artigo sobre créditos Lovable. Ficou com dúvida? O suporte atende pelo WhatsApp.

Lovable, Supabase, GitHub e Vercel são marcas de seus respectivos donos. A Pulse Coding é uma loja independente, sem vínculo com essas empresas.