Generar app de express y Node con express-generator

En este post voy a mostrar cómo crear la estructura inicial de una app de Node que utiliza el framework Express, usando el generador llamado express-generator.

Lo que veremos será:

  • Cómo instalar express-generator
  • Instalar las dependencias
  • Analizar la anatomía de la app, es decir, el proyecto, las vistas, etcétera

Nota: este ejemplo podría ser una “mejora” a la plantilla que vimos anteriormente.

Requisitos previos

Simplemente instala Node y NPM.

Instalar express-generator globalmente

Para tener el generador disponible en la PATH, hay que instalarlo globalmente con:

npm install -g express-generator

Un vistazo a express-generator

Ahora podemos ejecutar express --help para ver la ayuda.

Para crear un proyecto la sintaxis es:

express [opciones] ruta_del_proyecto

La carpeta que indica la ruta será creada al ejecutar el comando, no te preocupes.

Ayuda de Express Generator

Tenemos algunas opciones interesantes. Por ejemplo, la opción de --ejs, --pug o --hbs agrega soporte para esos motores de plantillas.

Podemos especificar el motor que usarán las plantillas con --view motor.

Otra opción muy buena es el motor de CSS, que puede ser less, stylus, compass, sass o, por defecto, simple CSS.

La opción --force es para que el proyecto sea creado en un directorio incluso si el mismo no está vacío.

Generar proyecto con express

Entonces para generar un proyecto que utilice EJS usamos:

express --view ejs crud-mysql

En este caso estoy creando un crud con MySQL que publicaré más tarde. En lugar de crud-mysql puedes especificar el nombre del directorio.

  • Cuando se haya creado debes ingresar a esa carpeta con cd crud-mysql
  • Después instalar las dependencias con npm install
  • Opcionalmente cambiar el puerto
  • Ejecutar la app con SET DEBUG=crud-mysql:* & npm start
  • Visitar localhost:3000 (o el número de puerto que hayas especificado)

Ejecutar app de Express

En el navegador se mostrará la página de bienvenida de Express, renderizada, por cierto, con EJS.

Anatomía del proyecto

Bueno bueno, ya generamos nuestra app pero no he explicado el código y su funcionamiento.

Anatomía de la aplicación de Node

Las rutas van en la carpeta routes, por cada módulo debe ir un archivo. En este caso estoy mostrando unas rutas de productos en productos.js.

Para cargar esas rutas hay que requerirlas e indicarle a la app que responda a las mismas con app.use.

Dentro de la carpeta views están las vistas, para ver un ejemplo de su renderizado podemos abrir routes/index.js que va a renderizar la vista llamada index.ejs:

Renderizar vista con EJS

Como segundo argumento a res.render() se pasa un objeto con las variables que serán renderizadas.

Por cierto, dentro de la vista se puede acceder a los recursos públicos almacenados en public. En este caso se está cargando el estilo CSS:

Directorio público de express app

Conclusión

A partir de aquí, podemos empezar a crear aplicaciones robustas, pues ya tenemos una estructura definida y usada por miles de desarrolladores alrededor del mundo.

Muy pronto traeré un ejemplo de esta app con MySQL.

Generar app de express y Node con express-generator

Por parzibyte Tiempo de lectura: 2 min
0