Saltar al contenido principal
Sigue este quickstart para añadir Base44 a tu proyecto Hono. Crearás un backend de Base44, definirás entidades e integrarás el SDK en tus rutas de API.
El CLI requiere Node.js 20.19.0 o superior.

​
Configuración

1

Instala el CLI de Base44

Instala el CLI de Base44 globalmente:
npm install -g base44@latest
2

Crea un backend de Base44

Navega al directorio de tu proyecto Hono y ejecuta:
base44 create
Si aún no has iniciado sesión, el comando te pedirá que te autentiques.Selecciona Create a basic project cuando se te indique. Esto crea los archivos del backend dentro del directorio de tu proyecto Hono. Luego sigue las indicaciones para configurar tu proyecto.Cuando creas un proyecto, las skills de Base44 se incluyen automáticamente, proporcionando a tu agente de IA instrucciones y contexto para las tareas de Base44.
3

Configura el directorio de salida (opcional)

Si estás sirviendo archivos estáticos con Hono, actualiza config.jsonc para que apunte a la salida de tu build. Añade o modifica el campo site.outputDirectory:
{
  "site": {
    "outputDirectory": "dist"
  }
}
Si estás creando una API pura con Hono y no sirves un frontend, puedes saltarte la configuración de outputDirectory u omitir este paso.
4

Define entidades

Crea esquemas de entidades para definir tus estructuras de datos. Los archivos de entidades deben colocarse en el directorio base44/entities/.Por ejemplo, crea base44/entities/task.jsonc:
{
  "name": "Task",
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "completed": {
      "type": "boolean",
      "default": false
    }
  },
  "required": ["title"]
}
5

Envía las entidades a Base44

Envía los esquemas de tus entidades a Base44:
base44 entities push
Este comando sincroniza tus definiciones de entidades locales con tu backend de Base44, haciéndolas disponibles para su uso en tu aplicación. Consulta entities push para más información.
6

Instala el SDK de Base44

Instala el SDK de JavaScript de Base44:
npm install @base44/sdk
7

Crea un cliente de Base44

Crea un cliente del SDK de Base44 en tu proyecto. El appId se puede encontrar en tu archivo base44/.app.jsonc.Por ejemplo, crea lib/base44.js:
import { createClient } from '@base44/sdk';

export const base44 = createClient({
  appId: 'your-app-id-from-app.jsonc'
});
8

Usa el SDK en tus rutas de API

Usa el SDK de Base44 para interactuar con tus entidades en los handlers de rutas de Hono. Por ejemplo:
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;
Usa el nombre exacto de la entidad de tu esquema al llamar al SDK, incluida la capitalización. Por convención, los nombres de entidades comienzan con mayúscula. Por ejemplo, si tu esquema tiene "name": "Task", accedes a ella como base44.entities.Task.list().
9

Ejecuta tu API localmente

Inicia tu servidor de desarrollo de Hono para probar tu integración. Desde la raíz de tu proyecto, ejecuta:
npm run dev
Tu API de Hono se conectará a tu backend de Base44 a través del cliente del SDK, lo que te permite trabajar con tus entidades desplegadas en tiempo real.

​
Siguientes pasos

Ahora que tu backend de Base44 está integrado con tu proyecto, puedes:
  • Usar el SDK para añadir más funcionalidad a tu API.
  • Añadir entidades, funciones de backend y agentes. Si trabajas en TypeScript, genera tipos para obtener autocompletado y seguridad de tipos.
  • Probar localmente ejecutando base44 dev para el backend de Base44 junto con tu servidor de desarrollo de Hono. Consulta Desarrollo local para las instrucciones de configuración.
  • Seguir creando tu API y desplegarla según el runtime que elijas.

​
Ver también

Esta página se tradujo con IA. Para información más precisa y actualizada, consulta la versión en inglés.