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 React 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 React. 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 React y define los comandos para compilar y servir. Añade los campos Con
site.outputDirectory, site.buildCommand y site.serveCommand: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 JavaScript de Base44:
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.js: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.jsx: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 app localmente
Inicia tu servidor de desarrollo de Vite para probar tu integración. Desde la raíz de tu proyecto, ejecuta:Tu proyecto React 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.
10
Construye y despliega tu frontend
Construye tu proyecto React 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:- Usar el SDK para añadir más funcionalidad a tu frontend.
- 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 devpara el backend ynpm run devpara el frontend. Consulta Desarrollo local para las instrucciones de configuración. - Seguir creando tu frontend y desplegar actualizaciones con
base44 deploy. - Abrir tu sitio desplegado con
base44 site open.
Ver también
- Referencia de comandos del CLI: Todos los comandos del CLI disponibles
- Estructura del proyecto: Cómo se organizan los archivos del proyecto
- Documentación del SDK de JavaScript: Conecta tu app al backend
- Skills de Base44: Enseña a los asistentes de IA a trabajar con Base44
Esta página fue traducida con IA. Para obtener la información más precisa y actualizada, consulta la versión en inglés.