Crear un nuevo proyecto con nodejs es el primer paso hacia la implementación de aplicaciones dinámicas y potentes, son embargo, mucho de nosotros no sabemos cómo empezar. En este tutorial, te guiaré a través de los pasos esenciales para establecer tu entorno local, ejecutar líneas de código clave y levantar un servidor con un simple “Hola Mundo”.
Ambiente Local
Antes de comenzar, asegúrate de tener Node.js y npm (Node Package Manager) instalados en tu máquina. Si no los tienes instalados, sigue estos pasos:
Linux
Abre tu terminal y ejecuta los siguientes comandos:
sudo apt update
sudo apt install nodejs
sudo apt install npm
Windows
Descarga e instala Node.js y npm desde el sitio oficial de Node.js. Deberías descargar un ejecutable y luego serguir los pasos.
Crear un nuevo proyecto con nodejs
- Abre tu terminal y navega hasta la carpeta donde deseas crear el proyecto.
- Ejecuta el siguiente comando para inicializar un nuevo proyecto de Node.js:
npm init -y
Esto creará un archivo package.json
con la configuración predeterminada.
Ahora, instalaremos algunas librerías base que yo ocupo cuando inicio un proyecto, estas son:
npm install express cors dotenv multer -S
Esto agregará a nuestro archivo package.json las dependencias del proyecto.
Tambien agregaremos la librería nodemon, en nuestro ambiente de desarrollo, esto es muy útil cuando necesitamos que al hacer cambios al momento de estar desarrollando en nuestro proyecto, se reflejen los cambios inmediatamente, sin tener que bajar y subir servicios.
npm i nodemon -D
Luego nos vamos a nuestro archivo package.json y modificamos el script, debería quedar así:
"scripts": {
"start": "node src/app.js",
"dev": "nodemon --watch src src/app.js"
},
Nuestro archivo de inicio puede ser app.js, index.js, server.js, etc… esto dependerá del nombre que eligas al momento de crear el archivo. En nuestro caso crearemos un archivo en la raíz llamado app.js, y ponemos el siguiente código:
require("dotenv").config()
const express = require("express")
const cors = require("cors")
const app = express()
app.use(cors())
const port = process.env.PORT || 3000;
// Levantar el servidor y escuchar en el puerto especificado
app.listen(port, () => {
console.log(`Servidor escuchando en http://localhost:${port}`);
});
Ahora para levantar nuestro server y que se actualize al guardar cambios usamos dev:
npm run dev
Variables de entorno
Para nuestras variables del proyecto, creamos un archivo .env, el cual debe estar en la raíz del proyecto y en nuestro ejemplo pondremos como variable el puerto de donde se debe levantar nuestra aplicación node
PORT:3000
Git
Si nuestro proyecto lo subimos a git, necesitaremos un archivo .gitignore, en el cual le diremos a git qué archivos no se deben subir al repositorio, en nuestro caso sería
node_modules/
.env
Es una muy buena practica dejar el archivo .env fuera del repositorio git
Código del Hola Mundo
- Crea un archivo
app.js
(como se mencionó antes, aquí puedes poner el nombre que desees, app.js, index.js, server.js, etc) en la raíz del proyecto. - Abre
app.js
en tu editor de código favorito y agrega el siguiente código:
require("dotenv").config()
const express = require("express")
const cors = require("cors")
const app = express()
app.use(cors())
const port = process.env.PORT || 3000;
// Ruta para manejar solicitudes GET a la raíz del servidor
app.get('/', (req, res) => {
res.send('¡Hola Mundo desde Express!');
});
// Ruta adicional para ilustrar otra funcionalidad
app.get('/saludo', (req, res) => {
res.send('Saludos desde Express');
});
// Levantar el servidor y escuchar en el puerto especificado
app.listen(port, () => {
console.log(`Servidor escuchando en http://localhost:${port}`);
});
Levantamiento del Servidor
En tu terminal, ejecuta el siguiente comando para iniciar el servidor
node app.js
Abre tu navegador y navega a http://localhost:3000
. Deberías ver el mensaje “¡Hola Mundo!”
Puedes acceder a visitando http://localhost:3000/saludo
en tu navegador. Acá tendrás el mismo mensaje, pero la diferencia que estarás utilizando la librería Express.
Este código es solo un punto de partida, y Express ofrece una amplia variedad de funcionalidades para el manejo de rutas, parámetros, middleware y más. Puedes personalizar estas rutas y funcionalidades según tus necesidades específicas a medida que avanzas en el desarrollo de tu aplicación.
¡Felicidades! Has creado tu primer proyecto Node.js, levantado un servidor y mostrado un “Hola Mundo”. A partir de aquí, puedes construir y expandir tu aplicación según tus necesidades.
Aqui te dejo el link a github con un proyecto node en blanco, con conexion a mongodb, que puede ser el punto de partida para tu proyecto.