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.
CenárioComando
Começando do zero, quer um NOVO aplicativo Base44 + projeto de um modelonpx base44 create
Você já tem um aplicativo Base44 (pelo ID) e quer arquivos locais para elenpx base44 scaffold
Tem um base44/config.jsonc local mas nenhum .app.jsoncnpx base44 link

​
Sintaxe

npx base44 scaffold [name] [options]
Cria a estrutura no diretório atual.

​
Argumentos e opções

Argumento/OpçãoDescriçãoObrigatório
nameNome do projeto (posicional). Padrão para o nome do diretório atual.Não
--app-id <id>ID de aplicativo Base44 existente. Recorre à variável de ambiente BASE44_APP_ID.Sim*
--no-skillsPula a instalação de habilidades de agente de IA (habilidades são instaladas por padrão)Não
*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

# Cria estrutura no diretório atual para um aplicativo existente
npx base44 scaffold --app-id app_123

# Cria estrutura no diretório atual com um nome de projeto explícito
npx base44 scaffold my-app --app-id app_123

# Fornece o ID do aplicativo via variável de ambiente em vez da flag
BASE44_APP_ID=app_123 npx base44 scaffold

# Cria estrutura sem instalar habilidades de agente de IA
npx base44 scaffold --app-id app_123 --no-skills

​
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: 
npx base44 scaffold
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.