base44 link
Vincula um projeto Base44 local existente a um aplicativo Base44 na nuvem. Use isto quando você tem umbase44/config.jsonc mas ainda não o conectou a um aplicativo Base44.
Crítico: Quando usar Link vs Create
| Cenário | Comando |
|---|---|
Começando do zero, sem pasta base44/ | npx base44 create |
Tem base44/config.jsonc mas sem .app.jsonc | npx base44 link |
Projeto já vinculado (tem .app.jsonc) | Já feito, use deploy |
Sintaxe
Opções
| Opção | Descrição | Obrigatório |
|---|---|---|
-c, --create | Cria um novo projeto (pula o prompt de seleção) | Não |
-n, --name <name> | Nome do projeto (obrigatório quando --create é usado) | Com --create |
-d, --description <description> | Descrição do projeto | Não |
--app-id <id> | ID do aplicativo para vincular a um projeto existente (flag global, pula o prompt de seleção) | Não |
Modo não interativo
Para uso em CI/CD ou por agentes: Criar um novo projeto:npx base44 link --create (falta —name)
ERRADO: npx base44 link --create --app-id <id> (não pode usar ambos)
CERTO: npx base44 link --create --name my-app
CERTO: npx base44 link --app-id <id>
Exemplos
O que faz
- Encontra o
base44/config.jsoncno diretório atual (ou diretórios pai) - Verifica se nenhum
.app.jsoncexiste (projeto ainda não vinculado) - Ou:
- Cria um novo aplicativo Base44 na nuvem (com
--create), OU - Vincula a um aplicativo existente (com
--app-idou seleção interativa)
- Cria um novo aplicativo Base44 na nuvem (com
- Grava o ID do aplicativo em
base44/.app.jsonc
Requisitos
- Deve ter
base44/config.jsoncno projeto - NÃO deve ter
base44/.app.jsonc(usedeployse já vinculado) - Deve estar autenticado (execute
npx base44 loginprimeiro)
Notas
- Após vincular, você pode implantar recursos com
npx base44 deploy - O arquivo
.app.jsoncdeve 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.

