Sair do Bubble começa por saber o que o seu app realmente faz
O UnBubble é o método que usamos nas nossas migrações do Bubble, publicado como open source. Ele lê o export do seu app na sua máquina e o transforma numa auditoria do que está morto, na documentação do que sobra e num plano de reconstrução que diz a quem for construir o sistema novo o que fazer e em que ordem.
Código aberto no GitHubApache 2.0 · funciona com Claude Code, Codex, Cursor e qualquer host de Agent Skills
Quatro coisas que o export não conta
O export é inventário, não planta
O arquivo .bubble lista cada página, workflow e campo, ligados por ids gerados. Ele registra o que existe sem dizer o que importa, e um agente que o lê cru preenche as lacunas adivinhando.
Anos de edição deixaram peso morto
Páginas para as quais nada navega, workflows que nada dispara, plugins ainda num plano pago. Reconstruir isso é desperdício, e não saber quais são transforma cada estimativa em chute.
As credenciais só existem no app antigo
Chaves de API e configurações de integração muitas vezes não estão em nenhum outro lugar. Perdê-las no meio da reconstrução trava o projeto num acesso que ninguém lembra de ter concedido.
A virada quebra o que ninguém listou
Webhooks, consumidores da Data API e URLs antigas continuam chamando o app. Uma reconstrução que nunca os listou quebra integrações no dia da troca.
Quatro etapas, do export à virada
Cada etapa é uma skill que o seu agente de código executa. Por trás de cada skill há scripts que tiram os fatos do export, para o agente não ter de adivinhá-los.
01
Auditoria
Um relatório interativo lista o que não é usado em dez áreas do app, como páginas, workflows de backend, plugins e campos, e dá a cada item um nível de confiança. Você limpa o app e o exporta de novo antes de qualquer reconstrução.
02
Clone e level-up
O clone documenta o banco, as APIs, os workflows e as regras de negócio numa forma verificável, e guarda cada credencial que o export traz num .env local. O level-up desenha a arquitetura alvo, o novo modelo de dados e o plano de migração.
03
Reconstrução
A reconstrução parte de um backlog atômico, seja com o seu time, com um agente de código ou com a Yowpi. Dois gates mantêm a reconstrução honesta: todo requisito tem uma história, e toda coluna migrada é lida ou escrita pelo código novo.
04
Virada
O plano de migração define como cada tabela se move (CSV ou Data API), a janela da virada, a reconciliação dos dados, que o dono do app assina, e o caminho de volta se algo falhar. Depois da troca, o app no Bubble fica como arquivo, só para leitura.
Roda onde o seu agente roda
Clone o repositório e conecte as skills ao agente que você já usa. Os scripts só precisam da biblioteca padrão do Python e rodam também sem agente.
git clone https://github.com/yowpi-tech/unbubble.gitVeja num app de demonstração antes do seu
A Tidewater Rentals é um app fictício de aluguel de equipamentos que criamos para mostrar o método. Em quase toda seção da auditoria, o export dela tem algo em uso e algo morto. O relatório abaixo é o que o UnBubble produziu a partir dele, sem retoque.
O export, o relatório e os scripts que os geraram estão no repositório: o app de demonstração
O que ele não faz
Listamos os limites da ferramenta logo de saída, do mesmo jeito que listamos os trade-offs de uma migração.
Ele não converte o seu app
Converter um app Bubble em código, peça por peça, leva para o código novo os mesmos problemas de arquitetura. O UnBubble faz a leitura e o planejamento; escrever o código continua sendo trabalho do seu time, de um agente de código ou nosso.
Ele lê o export, não o seu banco
O export traz a estrutura do app, não os registros. Os registros se movem por CSV ou pela Data API, na ordem que o plano de migração define.
Os seus dados ficam na sua máquina
O pipeline principal roda localmente, sem upload e sem conta. Um modo conectado, opcional e experimental, trabalha no app no ar pelo editor, e só com o consentimento do dono do app.
O que perguntam antes de testar
- O UnBubble é gratuito?
- Sim. É open source sob a licença Apache 2.0: você pode usar e modificar, inclusive comercialmente, desde que mantenha a licença e o aviso.
- E se eu não for sair do Bubble?
- A auditoria serve do mesmo jeito: saber o que está morto deixa o app mais fácil de manter e mostra os plugins pagos que nada usa. Você pode parar na auditoria e decidir a migração depois.
- Ele envia o meu export para algum lugar?
- Não. Os scripts leem o export onde ele está e escrevem numa pasta de projeto na sua máquina. As credenciais vão para um .env local que nunca entra nos documentos, e nada é enviado para nós.
- Com quais agentes de código ele funciona?
- Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot CLI e qualquer outro host que leia Agent Skills. Os scripts também rodam sozinhos, num terminal.
- E os termos de uso do Bubble?
- O pipeline principal só lê o export que o dono do app baixa do editor. O modo conectado, opcional, usa endpoints não documentados do editor, que podem mudar sem aviso. Por isso é experimental e só deve ser usado com o consentimento do dono do app, nunca desassistido.
- Vocês trabalham com agências?
- Sim. Quando uma migração for maior que o seu time, fale conosco sobre indicação.
- Quem mantém o UnBubble?
- A Yowpi Tech. Issues e pull requests são bem-vindos no GitHub, e o suporte é feito conforme a disponibilidade, sem SLA. Quando a migração precisa de um time, o caminho é o Diagnóstico de Arquitetura Operacional, logo abaixo.
Bubble e Bubble.io são marcas da Bubble Group, Inc. O UnBubble é um projeto independente, sem afiliação nem endosso da Bubble.
O modo conectado é construído sobre o befree-bubble-mcp, de Pedro Duarte (Befree Academy), licença MIT.
Quando a migração não pode parar a operação
O UnBubble entrega os fatos e o plano. Quando o app sustenta uma operação que não pode parar enquanto muda, fazemos a migração com o seu time, começando pelo Diagnóstico de Arquitetura Operacional: 30 minutos com o fundador da Yowpi sobre o que transfere, o que se redesenha e por onde começar. Assumimos até 6 projetos em paralelo.
Fale direto com o arquiteto que vai conduzir o projeto. Sem vendedores.