> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Atualizando seu app para a nova infraestrutura

> Atualize uma vez e ganhe melhor desempenho, mais estabilidade e novos recursos.

***

## Sobre a nova infraestrutura

Atualizamos a infraestrutura do Base44 para entregar tempos de carregamento mais rápidos, melhor desempenho, mais estabilidade e suporte a novos recursos avançados. Para ter esses benefícios, você precisa atualizar seu app para a nova infraestrutura manualmente.

Esse upgrade prepara seu app para tudo que vem a seguir no Base44, como a capacidade de adicionar [pacotes NPM](https://docs.base44.com/Building-your-app/NPM-packages) ao seu app. Também garante que seu app está pronto para futuras atualizações, novas ferramentas e melhorias contínuas conforme o Base44 evolui.

<Warning>
  **Importante:**

  * Apps novos já são criados na nova infraestrutura e não precisam atualizar. Se você não vê o botão de atualização no editor do app, é porque já está usando a nova infraestrutura.
  * Essa é uma **atualização única** necessária para apps antigos criados na infraestrutura antiga.
  * Você deve concluir a atualização até **1 de fevereiro de 2026**. Após essa data, se você ainda não tiver atualizado, seu app continua rodando e seus dados ficam seguros, mas o editor desse app é bloqueado. Você não pode editar nem publicar mudanças até atualizar para a nova infraestrutura. Você pode editar seu app novamente assim que concluir a atualização.
</Warning>

<Tip>
  Para ajudar você a começar com a nova infraestrutura, você recebe automaticamente **15 créditos** ao atualizar seu app.
</Tip>

***

## Atualizando seu app

Você pode atualizar seu app com um clique simples dentro do editor do app.

<Note>
  **Antes de começar:** Recomendamos [fazer backup dos dados do seu app](https://docs.base44.com/Building-your-app/Managing-your-app-data#exporting-data) antes de atualizar, caso precise restaurar algo depois.
</Note>

**Para atualizar seu app:**

1. Vá para o editor do app.
2. Clique em **Update Infrastructure** no topo.

<Frame>
  <img src="https://mintcdn.com/base44/9Q7KziXXEVqbm_ra/UpdateInfra.png?fit=max&auto=format&n=9Q7KziXXEVqbm_ra&q=85&s=f13d2667a4ad3c4c6a41d49f4ed61816" alt="Atualizando seu app Base44 para a nova infraestrutura" title="Atualizando seu app Base44 para a nova infraestrutura" className="mx-auto" style={{ width:"100%" }} width="911" height="128" data-path="UpdateInfra.png" />
</Frame>

Se você tiver algum problema, use o prompt de IA que aparece para corrigir o problema.

***

## Solução de problemas

A maioria dos apps migra sem problemas, mas algumas questões podem ocorrer durante a atualização. Siga as soluções abaixo ou entre em contato com o suporte se os problemas persistirem.

**Você pode encontrar os seguintes problemas:**

* **Preview não funciona:** Erros de build em arquivos gerados automaticamente, ou preview não carrega como esperado.
* **Rotas dinâmicas falhando:** Arquivos com \[param] no nome (por exemplo, pastas de rotas dinâmicas) causando erros de sintaxe ou de rota.
* **Diferenças de CSS ou estilo:** O build de produção fica diferente do preview após a atualização.
* **Erros de caminhos de import:** Código referenciando arquivos que foram movidos ou renomeados durante a migração.

**O que você pode tentar:**

* Se algum erro acontecer durante a atualização, você recebe uma notificação **Resolve with AI**. Deixe a IA corrigir os problemas para você.
* Se seu app estiver quebrado logo após a atualização e você ver uma opção Revert no editor, volte para a infraestrutura anterior temporariamente enquanto investiga.
* Se o preview funciona mas a produção não:
  * Saiba que o preview pode carregar recursos de CDN que a produção não inclui.
  * Garanta que qualquer framework de CSS como Tailwind esteja sendo empacotado corretamente para produção.
  * Limpe o cache do navegador e quaisquer caches de CDN após rebuildar, depois tente carregar o app ao vivo de novo.

**Quando contatar o suporte:**

* Erros aparecem em arquivos gerados automaticamente (como pages.config.js ou outros arquivos que você não criou).
* O problema parece estar relacionado a scripts de build no nível da plataforma e não ao seu próprio código.
* Reverter para a infraestrutura antiga e atualizar de novo produz os mesmos erros.

<Note>
  **Observação:** Alguns problemas de migração exigem correções no nível da plataforma. Ao contatar o suporte, inclua as mensagens de erro exatas, caminhos de arquivos e a URL do seu app para investigarmos mais rápido.
</Note>

***

## Perguntas frequentes

Clique em uma pergunta abaixo para saber mais.

<AccordionGroup>
  <Accordion title="Por que estou vendo erros em páginas não usadas?">
    Na infraestrutura antiga, erros em páginas não usadas eram ignorados. Na nova infraestrutura, esses erros aparecem na ferramenta **Resolve with AI**. Você pode corrigir os erros com "Resolve with AI" ou pedir para a IA remover páginas que não são mais necessárias no seu app.
  </Accordion>

  <Accordion title="Por que estou vendo erros sobre caminhos de import após atualizar?">
    Alguns erros podem ocorrer se seu código usa caminhos de import incorretos (por exemplo, usando a extensão errada como `.js` em vez de `.jsx`). Se você ver um erro de import path, copie a mensagem de erro e deixe a ferramenta **Resolve with AI** corrigir para você.
  </Accordion>

  <Accordion title="O que devo fazer se receber erros sobre uso do SDK legado?">
    Você pode encontrar erros em código usando dynamic imports com o SDK legado do Base44 (por exemplo, `import('@entities/all')`). Você pode resolver pedindo à IA para remover qualquer uso do SDK legado do seu app.
  </Accordion>

  <Accordion title="Posso voltar para a infraestrutura antiga?">
    Voltar para a infraestrutura antiga é possível, mas não é recomendado. Ao mover seu app de volta, você perde acesso às melhorias mais recentes de desempenho, estabilidade e recursos. Você também corre o risco de perder atualizações importantes no futuro.

    <Warning>
      **Importante:** Após 1 de fevereiro de 2026, você só poderá editar seu app se ele estiver na nova infraestrutura.
    </Warning>

    Para ajudar na transição, 15 créditos gratuitos são adicionados à sua conta para você testar e atualizar seu app conforme necessário. Recomendamos fortemente ficar na nova infraestrutura para ter a melhor experiência e atualizações. Nossa equipe de suporte está aqui para ajudar, então avise se estiver tendo problemas com a atualização.
  </Accordion>

  <Accordion title="O que acontece se eu não atualizar até 1 de fevereiro de 2026?">
    Se você não atualizar até essa data, seu app continua rodando normalmente. Quem usa seu app ainda consegue acessá-lo, e você ainda pode abrir o dashboard do app para ver dados, gerenciar acesso ou convidar colegas.

    No entanto, o editor desse app fica bloqueado. Você não pode abrir o editor, fazer mudanças nem publicar novas versões até atualizar para a nova infraestrutura. Assim que concluir a atualização, você pode editar e publicar de novo.
  </Accordion>

  <Accordion title="O que acontece se eu tiver vários apps para atualizar?">
    Você precisa atualizar cada app individualmente pelo editor do app; não tem como atualizar todos os seus apps de uma vez.

    Você recebe 15 créditos como um presente único para aproveitar a nova experiência. Você pode precisar usar alguns créditos se tiver que resolver algum problema durante as atualizações, mas isso é incomum. Note que você não recebe créditos extras por atualizar apps adicionais — os créditos são dados por usuário, não por app.
  </Accordion>
</AccordionGroup>

**Ainda precisa de ajuda?**

Se o problema persistir, [entre em contato](https://app.base44.com/support/conversations) e teremos prazer em ajudar. Para uma resposta mais rápida, inclua o nome ou URL do seu app, a versão do seu navegador e sistema operacional, e uma descrição ou screenshot do problema.