Skip to main content
Esta página faz parte de uma habilidade de agente de código IA e é escrita para agentes, não para humanos. Para a documentação legível por humanos da Base44, veja a documentação para desenvolvedores.

base44 scaffold

Cria a estrutura de um projeto local para um aplicativo Base44 existente. Use isto quando você já tem um aplicativo Base44 (você conhece seu ID) e quer configurar os arquivos do projeto local para trabalhar com ele. Roda totalmente de forma não interativa, então é seguro para agentes e CI.

Sintaxe

Cria a estrutura no diretório atual.

Argumentos e opções

*O ID do aplicativo é obrigatório: forneça via --app-id ou a variável de ambiente BASE44_APP_ID. Se nenhum for definido, o comando falha.

Exemplos

O que faz

  1. Resolve o ID do aplicativo a partir de --app-id ou da variável de ambiente BASE44_APP_ID
  2. Aplica o modelo backend-only ao diretório atual
  3. Registra os arquivos do projeto contra o aplicativo existente e grava base44/.app.jsonc com o ID do aplicativo
  4. Instala habilidades de agente de IA (a menos que --no-skills seja passado)

Transferência de provisionamento (Stripe Projects / projects.dev)

scaffold é o comando para executar depois que um aplicativo Base44 é provisionado por meio de um fluxo Stripe Projects / projects.dev. Use scaffold, não create — o aplicativo já existe, então create criaria uma duplicata. Quando a Base44 é provisionada dessa forma, as credenciais são injetadas no ambiente sob o prefixo BASE44_PROJECTS_ (por exemplo, BASE44_PROJECTS_BASE44_APP_ID, BASE44_PROJECTS_BASE44_ACCESS_TOKEN, BASE44_PROJECTS_BASE44_REFRESH_TOKEN). A CLI normaliza automaticamente esses para os nomes simples que ela usa (BASE44_APP_ID, BASE44_ACCESS_TOKEN, …). Como resultado:
  • ID do aplicativo é resolvido de BASE44_APP_ID automaticamente — sem necessidade de flag --app-id.
  • Autenticação é semeada de BASE44_ACCESS_TOKEN / BASE44_REFRESH_TOKEN — sem necessidade de npx base44 login interativo.
Portanto, toda a etapa pós-provisionamento é apenas:
Execute-o do diretório onde você quer os arquivos do projeto. Depois de criar a estrutura, envie recursos com npx base44 deploy.

Notas

  • Modelo: Sempre usa o modelo backend-only (apenas configuração Base44 — nenhum frontend é gerado).
  • Não interativo: Nunca solicita. Ele não envia entidades ou implanta o site. Use npx base44 deploy depois para enviar recursos.
  • Apenas aplicativo existente: Ao contrário de create, isto não cria um novo aplicativo Base44 — ele vincula arquivos locais ao ID de aplicativo que você fornece.
  • Autenticação: Requer que você esteja autenticado (execute npx base44 login primeiro).
  • O arquivo .app.jsonc deve ser ignorado pelo git (contém seu ID de aplicativo).
Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a versão em inglês.