Pular para o conteúdo principal
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:
npm install -g base44@latest
2

Crie um backend Base44

Navegue até o diretório do seu projeto Hono e execute:
base44 create
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:
{
  "site": {
    "outputDirectory": "dist"
  }
}
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:
{
  "name": "Task",
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "completed": {
      "type": "boolean",
      "default": false
    }
  },
  "required": ["title"]
}
5

Envie entidades para a Base44

Envie seus schemas de entidade para a Base44:
base44 entities push
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:
npm install @base44/sdk
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:
import { createClient } from '@base44/sdk';

export const base44 = createClient({
  appId: 'your-app-id-from-app.jsonc'
});
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:
import { Hono } from 'hono';
import { base44 } from './lib/base44Client';

const app = new Hono();

// Get all tasks
app.get('/api/tasks', async (c) => {
  const tasks = await base44.entities.Task.list();
  return c.json(tasks);
});

// Create a new task
app.post('/api/tasks', async (c) => {
  const body = await c.req.json();
  const newTask = await base44.entities.Task.create({
    title: body.title,
    completed: false
  });
  return c.json(newTask, 201);
});

export default app;
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:
npm run dev
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.