Quickstart Backend

Esta guía te ayudará a poner en marcha el servicio backend de Lynx de forma rápida y sencilla utilizando pnpm.

1. Prerrequisitos

Asegúrate de tener instaladas las siguientes herramientas:

• Node.js v24 o superior.
• pnpm v11 o superior.
• Docker (para gestionar la base de datos local).

2. Instalación y Preparación

Desde la raíz del proyecto, instala las dependencias y compila los paquetes compartidos necesarios:

pnpm install
pnpm --filter=@lynx/nest^... build

3. Infraestructura de Base de Datos

Inicia el contenedor de PostgreSQL y aplica las migraciones para preparar el esquema:

# Iniciar base de datos (Desde el root)
pnpm docker up -d

# Aplicar migraciones (Desde el root)
pnpm --filter=@lynx/models db:migrate

4. Configuración de Entorno

El backend requiere un archivo de variables de entorno. Crea tu archivo local en la carpeta del backend:

cd apps/nest
cp .env.example .env.development

Consejo

Revisa el archivo apps/nest/.env.development y asegúrate de que DATABASE_URL coincide con las credenciales de tu base de datos local.

5. Ejecución del Servidor

Para iniciar el servidor en modo desarrollo con recarga en caliente (Hot Module Replacement):

# Desde la raíz del proyecto
pnpm --filter=@lynx/nest dev

Alternativa con Turbo

Si prefieres utilizar Turborepo para la ejecución:

turbo run dev --filter=@lynx/nest

La API estará disponible y escuchando en http://localhost:4200.

Nota

Si necesitas realizar un setup completo de todo el monorepo (incluyendo frontends), puedes utilizar el comando global pnpm lynx setup.