Tema 1 · Fundamentos & CLI

1. Introducción a NestJS: Por qué TypeScript en el Backend, Arquitectura y Nest CLI

Comprende qué problema arquitectónico resuelve NestJS sobre Express/Fastify, cómo instalar @nestjs/cli y la estructura de un proyecto empresarial.

¿Qué es NestJS y qué problema resuelve en Node.js?

NestJS es un framework progresivo de Node.js para construir aplicaciones del lado del servidor eficientes, confiables y escalables utilizando TypeScript de forma nativa.

Mientras que librerías minimalistas como Express o Fastify ofrecen gran libertad inicial, carecen de una arquitectura definida: a medida que el equipo crece, cada desarrollador organiza las carpetas, validaciones y servicios a su manera, derivando en código espagueti difícil de mantener.

📌 Regla Mnemotécnica Fundamental: NestJS aporta al ecosistema Node.js la arquitectura modular, los decoradores y el contenedor de Inyección de Dependencias que hicieron famosos a Angular y Spring Boot, manteniendo por debajo la velocidad de Express o Fastify.

Instalación del Nest CLI y Creación del Proyecto

La herramienta oficial de línea de comandos (@nestjs/cli) permite inicializar proyectos con TypeScript configurado, ESLint, Prettier y Jest listos para usar, además de generar módulos, controladores y servicios siguiendo convenciones estrictas:

# 1. Instalar globalmente el CLI oficial de NestJS
npm i -g @nestjs/cli

# 2. Crear un nuevo proyecto empresarial con modo estricto
nest new kilopolis-api --strict

# 3. Iniciar el servidor en modo desarrollo con recarga en caliente (watch)
cd kilopolis-api
npm run start:dev
Archivo Base en src/ Responsabilidad Arquitectónica
main.ts Punto de entrada de la aplicación. Utiliza NestFactory.create(AppModule) para arrancar el servidor HTTP.
app.module.ts Módulo raíz (Root Module) donde se ensamblan los demás módulos de dominio de la plataforma.
app.controller.ts Controlador básico encargado de recibir peticiones HTTP y delegarlas al servicio.
app.service.ts Proveedor inyectable (@Injectable()) con la lógica de negocio aislada de la capa HTTP.

⚡ Punto de Entrada de una Aplicación NestJS (src/main.ts)

Arranque asíncrono de la aplicación con NestFactory, prefijo global de API y puerto configurable:

src/main.ts
Solo lectura
import { NestFactory } from '@nestjs/core';
import { Logger } from '@nestjs/common';
import { AppModule } from './app.module';

async function bootstrap(): Promise<void> {
  const logger = new Logger('Bootstrap');

  // Crea la instancia de la aplicación NestJS (usa Express por defecto bajo el capó)
  const app = await NestFactory.create(AppModule);

  // Define el prefijo global para todos los endpoints REST (ej: /api/v1/...)
  app.setGlobalPrefix('api/v1');

  // Habilita CORS para permitir consumo desde frontends autorizados
  app.enableCors({
    origin: ['https://academia.kilopolis.com', 'http://kilopolis.local'],
    credentials: true,
  });

  const port = process.env.PORT ? Number(process.env.PORT) : 3000;
  await app.listen(port);

  logger.log(`¡Hola Mundo! Servidor NestJS activo en http://localhost:${port}/api/v1`);
}

bootstrap();
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Qué clase estática del paquete @nestjs/core se utiliza en el archivo src/main.ts para inicializar y arrancar la aplicación a partir de AppModule?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar NestJS Framework Profesional y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.