Como exportar o código do Base44 e hospedar o app fora

O Base44 deixa exportar o código a partir do plano Builder, por arquivo ZIP ou pela sincronização com o GitHub. O que sai é um projeto React com Vite, com o front, as funções de backend e a estrutura das tabelas. Banco, login e integrações continuam rodando no Base44, então hospedar tudo fora exige trocar esse backend.

Recomendação da Heartscale: antes de exportar, levante as chamadas ao SDK do Base44 no código e decida se basta tirar o front ou se o backend inteiro precisa sair. Se o app tem login e dados pessoais, planeje a redefinição de senhas e peça uma revisão das permissões antes de virar.

Qual plano libera a exportação

Segundo a página de ferramentas para desenvolvedores do Base44:

• Free: você vê o código do app, mas não edita.
• Planos pagos: liberam a edição do código.
• Builder ou superior: liberam a exportação por ZIP e a conexão com o GitHub.

Na página de preços, em outubro de 2026, o Builder custa US$ 40 por mês no pagamento anual. É o plano mais barato que inclui a integração com o GitHub.

O que vem no código e o que fica no Base44

A documentação descreve o ZIP como um projeto React padrão feito com Vite. A tabela resume o que sai e o que não sai:

Item	Vem no ZIP ou no GitHub?	Onde fica depois
Front (React + Vite)	Sim	Onde você hospedar
Funções de backend	O código, sim	Continuam rodando no Base44
Estrutura das tabelas (campos e permissões)	Sim	Os dados continuam no Base44
Dados das tabelas	Não	Exporte em CSV pela área Data
Usuários do app	Não	Exporte em CSV pela área App Users
Segredos	Não	Ficam no Base44
Histórico de versões	Não (o ZIP traz só a versão salva)	Fica no Base44

O ponto central está na mesma página: o código exportado usa o SDK do Base44. Por isso, dados, login, funções e integrações seguem no Base44 e usam os dados do app publicado. A documentação diz que hospedar o backend por conta própria não é suportado. Rodar tudo fora exige trocar banco, login e integrações e reescrever o código que chama cada um.

Vale saber o que esse backend faz, segundo a visão geral do backend do Base44:

• Entidades: banco NoSQL compatível com MongoDB, sem esquema obrigatório.
• Login: e-mail e senha, Google, Microsoft, Facebook, Apple e SSO.
• Funções: TypeScript rodando em Deno, sem servidor para você manter.
• Integrações embutidas: SendEmail, UploadFile, invokeLLM, GenerateImage e outras. Elas rodam na infraestrutura do Base44 e consomem créditos de integração (Built-in integrations).
• Hospedagem: só aplicação de página única, com domínio próprio e HTTPS. Não há renderização no servidor.

Passo 1: exporte o código em ZIP

Pela documentação:

1. Abra o app no editor do Base44, num computador. A exportação não existe no editor pelo celular.
2. Clique no ícone More actions, no canto superior direito.
3. Escolha Export project as ZIP.
4. Clique em Download ZIP.

Você precisa de permissão de edição no app. O ZIP é uma foto do código daquele momento.

Passo 2: ou conecte o GitHub

O GitHub é melhor se o app ainda vai mudar. A integração com o GitHub funciona assim:

1. No editor, clique em Dashboard.
2. Clique no ícone do GitHub, no alto à direita, e depois em Connect to GitHub.
3. Clique em Connect GitHub e autorize o Base44 Builder.
4. Escolha a conta ou organização e os repositórios liberados. Clique em Install.
5. Dê nome ao repositório e clique em Create Repository.

Regras que costumam surpreender:

• Só o dono do app conecta, reconecta ou vincula um repositório.
• A sincronização é automática nos dois sentidos. Não há push manual.
• O branch padrão tem de se chamar main. Outro nome, como master, não é aceito.
• Mudanças no main chegam ao Base44, mas só vão ao ar depois de clicar em Publish.
• Não há como pausar a sincronização: ou está conectado, ou não está.
• Depois de desconectar, a reconexão exige outro nome de repositório.
• O Version History não volta a versões anteriores à integração. Só restaura o que está no repositório.

Não confunda com o conector GitHub API, que serve para o app ler issues e pull requests. Ele não sincroniza código (Connecting GitHub to your app).

Passo 3: exporte os dados e os usuários

O código não leva nenhum registro. Pela página de dados do app:

1. No editor, clique em Dashboard e depois em Data.
2. Escolha a tabela.
3. Clique em More actions e em Export. Com filtro ativo, a opção vira Export filtered records e baixa só o que aparece.
4. Repita para cada tabela.

A tela mostra até 5.000 itens por tabela. O CSV traz todos.

Para a lista de usuários, a página sobre dados de usuários indica Dashboard → App Users → More actions → Export to CSV. Os dois arquivos trazem todas as linhas, com dados pessoais de todos os usuários. Guarde em lugar seguro.

A documentação não diz quais colunas o CSV de usuários traz e não fala em senhas. Se você for trocar o login, planeje uma redefinição de senha para todos.

Passo 4: escolha onde hospedar

Há dois caminhos, com tamanhos de trabalho muito diferentes.

Caminho A: só o front fora, backend no Base44

É o caminho que a documentação suporta. Você hospeda o front onde quiser e ele continua chamando o backend do Base44. Na prática:

1. Pegue o código pelo GitHub ou pelo ZIP.
2. Confira o script build no package.json e gere os arquivos estáticos.
3. Publique numa hospedagem de site estático ou numa VPS. Configure o servidor para mandar toda rota ao index.html, como em qualquer aplicação de página única.
4. Aponte o seu domínio.

O que muda: o endereço e o servidor do front. O que não muda: banco, login, funções, créditos de integração e a assinatura do Base44. Também existe a opção inversa: buildar fora e publicar os arquivos na hospedagem do Base44, com domínio próprio e HTTPS automático.

Esse caminho resolve quem quer controle do front, um domínio próprio ou um pipeline de deploy seu. Não resolve quem quer parar de pagar o Base44 ou tirar os dados de lá.

Caminho B: sair do Base44 por completo

Aqui você troca cada peça do backend por uma sua. A lista mínima:

1. Banco. As entidades são NoSQL e não têm esquema obrigatório. Num banco relacional, como o PostgreSQL do Supabase, você define tabelas, tipos e chaves e importa os CSVs.
2. Permissões. As regras de acesso por linha e por campo do Base44 não vêm junto. Recrie cada uma. No Supabase, isso é RLS: veja como configurar RLS no Supabase.
3. Login. Configure de novo os provedores (Google, Microsoft, Apple) com credenciais suas e importe os usuários. Sem as senhas, peça a todos que redefinam.
4. Funções. Reescreva as funções de backend para o novo ambiente. Troque as chamadas ao SDK do Base44.
5. Integrações. Cada SendEmail, UploadFile ou invokeLLM precisa de um serviço seu, com chave de API sua.
6. Conectores. Conexões OAuth gerenciadas pelo Base44 precisam de um app OAuth seu em cada serviço.

Procure no código todas as chamadas ao SDK do Base44. Essa lista é o tamanho real da migração. Na nossa revisão, montamos essa lista arquivo por arquivo e anotamos, ao lado de cada chamada, a peça do backend novo que vai substituí-la.

Passo 5: teste e vire sem perder dados

1. Suba o app novo num endereço de teste, com uma cópia dos dados.
2. Teste login, cadastro, leitura, gravação, envio de arquivos e cada integração.
3. Na virada, pause o uso do app, exporte os CSVs de novo e importe a versão final.
4. Aponte o domínio para o servidor novo.
5. Só desative o app no Base44 depois de conferir os dados no destino.

Antes de compartilhar qualquer CSV com alguém da equipe, a própria documentação recomenda remover os dados de outras pessoas.

Se o seu app está no Lovable, e não no Base44, o caminho é outro: veja como sair do Lovable.

Fazer sozinho ou contratar?

Este guia basta para o caminho A; a tabela mostra quando vale ter uma equipe ao lado.

Situação	Caminho
Só o front fora, backend no Base44, e alguém no time que roda o build	Faça sozinho com este guia (caminho A)
Saída completa do Base44, com dados de usuários reais	Chame uma equipe para modelar o banco relacional e recriar as permissões
Login com Google, Microsoft ou Apple, ou dados pessoais no app	Peça o diagnóstico da Heartscale: ele lista cada chamada ao SDK e o que muda no login
Prazo curto ou ninguém técnico no time	Contrate a migração com preço fechado

Peça o diagnóstico da Heartscale

Nossa equipe levanta cada chamada ao SDK do Base44 no seu código, mede o volume de dados e define se vale o caminho A ou o B. Você recebe o plano da migração de plataforma com o que muda no banco, no login e nas integrações, e o preço fechado.

O diagnóstico de lançamento custa R$ 99 (de R$ 398) e é abatido se você fechar a migração. Só trabalhamos em app de quem prova ser dono.

Pedir o diagnóstico