Se você começou a construir plugins pro editor de plugins mobile do Bubble — que saiu da fase fechada e ficou disponível pra todo mundo em alpha no início de junho de 2026 — é bem provável que já tenha esbarrado nisso: você configura uma property de lista (por exemplo, um campo alimentado por um Search for…), tem dados de verdade no banco, mas na hora de rodar, a lista chega vazia dentro do seu componente. Sem erro visível, sem aviso, só… nada.
Não é falta de dado. Não é campo mal configurado. É um comportamento assíncrono conhecido do Bubble que, no editor mobile (ainda alpha), tem armadilhas que não existem — ou não se comportam do mesmo jeito — no editor web clássico.
O sintoma
Você recebe as properties no seu componente function(props), tenta ler uma lista (props.minha_lista), e quando chama os métodos padrão de leitura de lista do Bubble nela, o valor simplesmente não vem. Não importa se a busca (Search for…) tem resultado — na hora exata em que seu componente roda pela primeira vez, os dados ainda não terminaram de carregar.
Por que isso acontece
O Bubble tem, há tempos, um mecanismo interno para lidar com dados que ainda não carregaram: quando você tenta ler uma lista antes dela estar pronta, ele lança um erro especial — não um erro comum de JavaScript, mas um sinal específico que o próprio Bubble reconhece internamente para saber “essa informação ainda não chegou, espera e tenta de novo”.
Esse mecanismo é documentado oficialmente para Actions server-side. O problema é que, no editor de plugin mobile, que ainda está em alpha, esse “aviso” não é tratado da mesma forma automática e transparente. E aqui mora a armadilha mais comum:
Se o seu código (ou uma lib que você está usando) envolve a leitura da lista num try/catch genérico “pra não quebrar nada”, você está literalmente engolindo esse sinal. O resultado: a lista nunca preenche, e não sobra nem um erro no console pra te dar uma pista.
A armadilha dentro da armadilha
Tem um agravante, relatado por outros desenvolvedores no fórum oficial: nesse editor mobile ainda em alpha, se qualquer exceção não tratada escapar da função do seu componente, a aplicação inteira trava — não só o seu elemento. Um desenvolvedor relatou isso oficialmente à equipe do Bubble, alertando que confiar em qualquer biblioteca de terceiros nesse contexto é arriscado justamente por causa disso.
Ou seja: você não pode simplesmente “deixar o erro estourar” e confiar que o Bubble vai pausar e tentar de novo sozinho (como a documentação clássica sugere para Actions) — na prática, isso pode derrubar a tela inteira do usuário.
O caminho pra resolver (sem te dar o código pronto)
Não vou entregar aqui a implementação linha a linha — isso é fruto de bastante tentativa e erro — mas o caminho geral é este:
- Nunca engula esse erro especial silenciosamente. Se você tem qualquer try/catch em volta de leitura de lista, verifique explicitamente se o erro capturado é esse sinal especial antes de tratá-lo como um erro comum.
- Não relance esse erro pra cima sem cuidado. Diferente do comportamento clássico de Actions, relançar dentro de callbacks do React nesse editor mobile pode derrubar a aplicação inteira, não só pausar o componente.
- Implemente sua própria espera controlada. Em vez de depender do Bubble reprocessar sozinho seu componente quando os dados chegarem (o que não se mostrou confiável nesse editor ainda em alpha), vale construir um mecanismo de nova tentativa dentro do próprio plugin — com limite de tentativas e um estado visual de carregamento, pra nunca deixar o usuário travado numa tela em branco.
- Blinde cada camada. Como esse editor ainda está em alpha, vale tratar qualquer ponto de falha (não só a leitura de listas) com uma rede de segurança que nunca deixa uma exceção não tratada chegar até o topo.
Onde isso foi validado na prática
Essa abordagem foi testada de ponta a ponta num plugin próprio que usa listas dinâmicas (Search for…) pra alimentar conteúdo em tempo real — foi assim que o comportamento foi mapeado e confirmado em ambiente real, não só em teoria.
Plugin:
Resumindo
Esse não é um bug do seu app — é uma característica (ainda crua) de um editor em alpha. Ele vai amadurecer, mas até lá, quem constrói plugins mobile precisa saber que listas assíncronas exigem tratamento deliberado, e que confiar cegamente em padrões do editor web clássico pode custar caro numa tela em branco pro usuário final.
Se você está desenvolvendo pro editor mobile do Bubble e bateu nesse mesmo problema, comenta aqui — vale trocar experiência enquanto essa parte da plataforma ainda está se firmando.