Skip to main content
Sigue este quickstart para añadir Base44 a tu proyecto Refine. Crearás un backend de Base44, definirás entidades e integrarás Base44 como proveedor de datos en Refine.
El CLI requiere Node.js 20.19.0 o superior.

Configuración

1

Instala el CLI de Base44

Instala el CLI de Base44 globalmente:
2

Crea un backend de Base44

Navega al directorio de tu proyecto Refine y ejecuta:
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 Refine. 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 tu sitio

Actualiza tu config.jsonc para que apunte a la salida de build de Refine y define los comandos para compilar y servir. Añade los campos site.outputDirectory, site.buildCommand y site.serveCommand:
Con serveCommand definido, base44 dev inicia tu backend y tu frontend juntos desde una sola terminal. Con buildCommand definido, base44 build compila tu frontend con tu app ID inyectado.
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:
5

Envía las entidades a Base44

Envía los esquemas de tus entidades a Base44:
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 Base44 en tu proyecto Refine:
7

Crea un cliente de Base44

Crea un cliente del SDK de Base44 en tu proyecto. Lee el app ID desde VITE_BASE44_APP_ID, que base44 build y base44 dev definen automáticamente.Por ejemplo, crea src/api/base44Client.ts:
VITE_BASE44_APP_ID se resuelve al ID de tu app vinculada, que el CLI lee desde base44/.app.jsonc.
8

Usa el SDK en tu frontend

Crea un componente sencillo para listar y añadir tareas. Por ejemplo, crea src/components/TaskList.tsx:
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

Importa el componente en tu app

Actualiza tu src/App.tsx para usar el componente TaskList:
10

Ejecuta tu app localmente

Inicia tu servidor de desarrollo de Refine para probar tu integración. Desde la raíz de tu proyecto, ejecuta:
Tu app de Refine se conectará a tu backend de Base44 a través del proveedor de datos personalizado, gestionando automáticamente todas las operaciones CRUD.
11

Construye y despliega tu frontend

Construye tu proyecto Refine para producción con tu app ID inyectado y luego despliega:
base44 build ejecuta tu buildCommand con VITE_BASE44_APP_ID definido con el ID de tu app vinculada. base44 deploy sube los archivos compilados y envía cualquier actualización a tus esquemas de entidades. Cuando se complete, verás un enlace a tu panel de Base44 y la URL de tu aplicación en producción.

Siguientes pasos

Ahora que tu backend de Base44 está integrado con tu proyecto, puedes:

Ver también

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