Skip to main content
Siga este quickstart para adicionar a Base44 ao seu projeto Hono. Você criará um backend Base44, definirá entidades e integrará o SDK nas suas rotas de API.
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 Hono 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 Hono. 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 o diretório de saída (opcional)

Se você está servindo arquivos estáticos com Hono, atualize o config.jsonc para apontar para a saída do build. Adicione ou modifique o campo site.outputDirectory:
Se você está construindo uma API pura com Hono e não está servindo um frontend, pode pular a configuração de outputDirectory ou omitir este passo.
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. O appId pode ser encontrado no seu arquivo base44/.app.jsonc.Por exemplo, crie lib/base44.js:
8

Use o SDK nas suas rotas de API

Use o SDK da Base44 para interagir com suas entidades em route handlers do Hono. Por exemplo:
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 sua API localmente

Inicie seu servidor de desenvolvimento Hono para testar sua integração. A partir da raiz do projeto, execute:
Sua API Hono se conectará ao seu backend Base44 através do cliente SDK, permitindo trabalhar com suas entidades implantadas em tempo real.

Próximos passos

Agora que o backend Base44 está integrado ao seu projeto, você pode:
  • Usar o SDK para adicionar mais funcionalidade à sua API.
  • 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 dev para o backend Base44 junto com seu dev server do Hono. Veja Desenvolvimento local para instruções de configuração.
  • Continuar construindo sua API e implantá-la de acordo com o runtime escolhido.

Veja também

Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a versão em inglês.