A CLI requer Node.js 20.19.0 ou superior.
Configuração
1
Instale a CLI da Base44
Instale a CLI da Base44 globalmente:
2
Crie um backend Base44
Navegue até o diretório do seu projeto Vue e execute:Se você ainda não estiver logado, o comando vai solicitar que você autentique.Selecione Create a basic project quando solicitado. Isso cria os arquivos do backend dentro do diretório do seu projeto Vue. Em seguida, siga as instruções para configurar seu projeto.Quando você cria um projeto, as Base44 skills são incluídas automaticamente, fornecendo ao seu agente de IA instruções e contexto para tarefas da Base44.
3
Configure seu site
Atualize seu config.jsonc para apontar para a saída do build do Vue e definir os comandos de build e execução. Adicione os campos Com
site.outputDirectory, site.buildCommand e site.serveCommand:serveCommand definido, base44 dev inicia seu backend e frontend juntos em um único terminal. Com buildCommand definido, base44 build compila seu frontend com o ID do seu app injetado.4
Defina entidades
Crie schemas de entidade para definir suas estruturas de dados. Arquivos de entidade devem estar no diretório
base44/entities/.Por exemplo, crie base44/entities/task.jsonc:5
Envie entidades para a Base44
Envie seus schemas de entidade para a Base44:Este comando sincroniza suas definições locais de entidade com seu backend Base44, tornando-as disponíveis para uso na sua aplicação. Veja
entities push para mais informações.6
Instale o SDK da Base44
Instale o SDK JavaScript da Base44:
7
Crie um cliente Base44
Crie um cliente SDK da Base44 no seu projeto. Leia o ID do app de
VITE_BASE44_APP_ID, que base44 build e base44 dev definem automaticamente.Por exemplo, crie src/api/base44Client.js:VITE_BASE44_APP_ID resolve para o ID do app vinculado, que a CLI lê de base44/.app.jsonc.8
Use o SDK no seu frontend
Crie um componente simples para listar e adicionar tarefas. Por exemplo, crie
src/components/TaskList.vue:Use o nome exato da entidade do seu schema ao chamar o SDK, incluindo capitalização. Por convenção, os nomes de entidade começam com letra maiúscula. Por exemplo, se seu schema tem
"name": "Task", você acessa como base44.entities.Task.list().9
Execute seu app localmente
Inicie seu servidor de desenvolvimento Vue para testar sua integração. A partir da raiz do projeto, execute:Seu app Vue se conectará ao seu backend Base44 através do cliente SDK, permitindo trabalhar com suas entidades implantadas em tempo real.
10
Faça build e implante seu frontend
Faça build do seu projeto Vue para produção com o ID do seu app injetado, depois implante:O
base44 build executa seu buildCommand com VITE_BASE44_APP_ID definido como o ID do app vinculado. O base44 deploy envia os arquivos compilados e faz push de quaisquer atualizações nos seus schemas de entidade. Quando concluído, você verá um link para seu dashboard Base44 e a URL da sua aplicação ao vivo.Próximos passos
Agora que o backend Base44 está integrado ao seu projeto, você pode:- Usar o SDK para adicionar mais funcionalidade ao seu frontend.
- Adicionar entidades, funções de backend e agentes. Se está trabalhando em TypeScript, gere tipos para obter autocomplete e segurança de tipo.
- Testar localmente executando
base44 devpara o backend enpm run devpara o frontend. Veja Desenvolvimento local para instruções de configuração. - Continuar construindo seu frontend e implantar atualizações com
base44 deploy. - Abrir seu site implantado com
base44 site open.
Veja também
- Referência de comandos da CLI: Todos os comandos da CLI disponíveis
- Estrutura do projeto: Como os arquivos do projeto são organizados
- Documentação do SDK JavaScript: Conecte seu app ao backend
- Base44 Skills: Ensine assistentes de IA a trabalhar com a Base44
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.