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 create

Cria um novo projeto Base44 a partir de um modelo. Este comando é agnóstico a frameworks e pode criar a estrutura completa de um projeto ou adicionar configuração Base44 a um projeto existente.

​
Crítico: Modo não interativo obrigatório

SEMPRE forneça o nome do projeto E a flag --path. Sem ambos, o comando abre uma TUI interativa que agentes não podem usar corretamente. ERRADO: npx base44 create ERRADO: npx base44 create my-app CERTO: npx base44 create my-app -p ./my-app

​
Sintaxe

npx base44 create [name] --path <path> [options]

​
Argumentos e opções

Argumento/OpçãoDescriçãoObrigatório
nameNome do projeto (argumento posicional)Sim*
-p, --path <path>Caminho onde criar o projetoSim*
-t, --template <id>ID do modelo (veja modelos abaixo)Não
--deployConstrói e implanta o site (inclui envio de entidades)Não
--no-skillsPula a instalação de habilidades de agente de IA (habilidades são adicionadas por padrão)Não
*Obrigatório para modo não interativo. Tanto name quanto --path devem ser fornecidos juntos.

​
Seleção do modelo (CRÍTICO - Escolha adequadamente)

Você DEVE selecionar o modelo mais adequado com base nos requisitos do usuário:
ID do modeloQuando usarCenários de exemplo
backend-and-clientCriando um NOVO aplicativo web full-stack do zero”Create a task app”, “Build me a dashboard”, “Make a SaaS app”
backend-onlyAdicionando Base44 a um projeto EXISTENTE OU usando um framework diferente (Next.js, Vue, Svelte, etc.)”Add Base44 to my project”, “I want to use Next.js”, “I already have a frontend”
Escolha padrão: Quando o usuário pede para “criar um aplicativo” ou “construir um projeto” sem especificar um framework particular, use backend-and-client para fornecer um aplicativo completo e pronto para produção com Vite + React + Tailwind.

​
A flag --path

  • Para o modelo backend-and-client (novos projetos): Use um novo caminho de subpasta 
    npx base44 create my-app -p ./my-app -t backend-and-client
  • Para o modelo backend-only (projetos existentes): Use -p . no diretório atual 
    npx base44 create my-app -p .

​
Fluxo: Usando backend-only com frameworks externos

CRÍTICO: A pasta do projeto DEVE existir ANTES de executar base44 create com backend-only O modelo backend-only apenas adiciona arquivos de configuração Base44 - NÃO cria um frontend. Se você precisa de um frontend com um framework específico: 
# Step 1: Initialize the frontend project FIRST
npm create vite@latest my-app -- --template react  # or vue, svelte, etc.
# OR: npx create-next-app@latest my-app
# OR: any other framework's init command

# Step 2: Navigate into the created folder
cd my-app

# Step 3: Install Base44 CLI
npm install --save-dev base44

# Step 4: Add Base44 configuration
npx base44 create my-app -p .
AVISO: NÃO:
  • Crie uma pasta vazia manualmente e depois tente executar npx create vite dentro dela (falhará - a pasta existe)
  • Execute base44 create com backend-only esperando que ele crie um frontend (não fará)
FAÇA:
  • Execute o comando de inicialização do framework externo PRIMEIRO (ele cria sua própria pasta)
  • Depois execute base44 create dentro dessa pasta com -p .

​
Exemplos

# RECOMENDADO: Cria projeto full-stack (para novos aplicativos)
npx base44 create my-app -p ./my-app -t backend-and-client

# Cria full-stack e implanta em uma etapa
npx base44 create my-app -p ./my-app -t backend-and-client --deploy

# Adiciona Base44 a um projeto EXISTENTE (deve estar dentro da pasta do projeto)
npx base44 create my-app -p .

# Adiciona Base44 a um projeto existente e implanta
npx base44 create my-app -p . --deploy

# Cria sem adicionar habilidades de agente de IA
npx base44 create my-app -p . --no-skills

​
O que faz

  1. Aplica o modelo selecionado ao caminho de destino
  2. Cria uma pasta base44/ com arquivos de configuração
  3. Registra o projeto com o backend Base44
  4. Cria base44/.app.jsonc com o ID do aplicativo
  5. Se --deploy for usado:
    • Envia quaisquer entidades definidas em base44/entities/
    • Executa comandos de instalação e build (para modelos com frontend)
    • Implanta o site na hospedagem Base44
Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a versão em inglês.