Skip to main content
Use este guia para escrever código de backend localmente para um app Base44 que você já tem. O comando scaffold cria os arquivos de configuração que seu ambiente de desenvolvimento precisa e conecta seu ambiente local aos recursos de backend do seu app. O frontend permanece no editor visual da Base44. Diferente do eject, que cria um novo app e baixa seu código existente incluindo o frontend, o scaffold trabalha com seu app onde ele está.
  • Este guia requer o ID do seu app existente. Você o encontra na URL do app no editor de apps da Base44: app.base44.com/apps/<id>/...
  • A CLI requer Node.js 20.19.0 ou superior.
  • Se você quer uma abordagem diferente de desenvolvimento local para um app que já tem na Base44, considere estas opções:
    • Integração com GitHub: sincronização automática bidirecional com um repositório GitHub, requer o plano Builder.
    • base44 eject: crie uma cópia local separada do app como um novo projeto.
    • base44 link: vincule arquivos de projeto que já estão no disco a um backend Base44.
1

Instale a CLI

Instale a CLI da Base44 globalmente:
2

Crie ou navegue até o diretório do projeto

Crie um diretório para o seu projeto local e navegue até ele:
Você também pode executar scaffold em um diretório que já tem arquivos. O comando só grava arquivos que ainda não existem.
3

Faça o scaffold do projeto

Execute o comando scaffold com o ID do seu app:
Se você ainda não estiver logado, o comando vai solicitar que você autentique.A CLI cria arquivos de configuração no seu diretório e os vincula ao seu app na Base44.
Quando concluído, seu diretório contém:
  • base44/config.jsonc: Configuração do projeto, incluindo o nome do seu app e as configurações de visibilidade.
  • base44/.app.jsonc: Vincula seu diretório local ao seu app na Base44. Ignorado pelo git por padrão.
  • base44/.gitignore: Exclui arquivos gerados e secrets do controle de versão.
  • .agents/ e .claude/: Skills de agente de IA que ensinam sua IDE a trabalhar com a Base44. Passe --no-skills para pular isso.
Para detalhes sobre os arquivos gerados, veja Estrutura do Projeto.

​
Quando usar scaffold

Use scaffold quando você:
  • Quer escrever recursos de backend (entidades, funções, agentes) localmente enquanto o frontend permanece no editor visual da Base44. Para ter acesso local também ao código do frontend, use base44 eject.
  • Prefere deploys manuais em vez de sincronização automática, ou não tem o nível de plano exigido para a integração com GitHub.
  • Precisa configurar o desenvolvimento local em uma segunda máquina para o mesmo app.

​
Próximos passos

Agora que seu projeto está configurado, você pode:

​
Veja também

Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.