Crear un proyecto Node.js

1. Requisitos previos

Instala Node.js, que incluye npm, el gestor de paquetes.

Comprueba la instalación desde una terminal:

node -v
npm -v

Ambos comandos deberían mostrar sus respectivas versiones.

2. Crear la carpeta del proyecto

Crea una carpeta para el proyecto y entra en ella:

mkdir mi-proyecto
cd mi-proyecto

• mkdir: crea una carpeta.
• cd: permite entrar en una carpeta.

También puedes crear la carpeta desde Visual Studio Code y abrir una terminal dentro de ella.

3. Inicializar el proyecto

Ejecuta:

npm init -y

Esto genera el archivo package.json, donde se registra información del proyecto, sus dependencias y sus scripts.

La opción -y acepta automáticamente la configuración predeterminada. Si prefieres responder las preguntas una por una, utiliza npm init.

4. Crear el archivo principal

Crea un archivo llamado index.js:

console.log('¡Hola desde Node.js!')

Ejecuta el archivo con:

node index.js

Si todo funciona, aparecerá el mensaje en la terminal.

Importante: Node.js permite ejecutar JavaScript fuera del navegador. No necesitas Vite para ejecutar un archivo .js sencillo.

5. Instalar paquetes

Para instalar una dependencia, utiliza:

npm install nombre-paquete

Por ejemplo, para instalar Express, un framework para crear servidores web y APIs:

npm install express

Para instalar una herramienta que solo se utiliza durante el desarrollo:

npm install -D nombre-paquete

npm registra las dependencias en package.json y genera o actualiza package-lock.json.

6. Crear un servidor básico con Express

Instala Express:

npm install express

En index.js, escribe:

const express = require('express')

const app = express()
const PORT = 3000

app.use(express.json())

app.get('/', (req, res) => {
  res.send('¡Servidor funcionando!')
})

app.listen(PORT, () => {
  console.log(`Servidor disponible en http://localhost:${PORT}`)
})

Inicia el servidor:

node index.js

Abre http://localhost:3000 en el navegador.

Este ejemplo utiliza CommonJS (require). Si configuras el proyecto como módulo ES con "type": "module" en package.json, utiliza import en lugar de require.

7. Crear un script para ejecutar el servidor

En package.json, agrega un script dentro de "scripts":

{
  "scripts": {
    "start": "node index.js"
  }
}

Si el archivo ya contiene otros campos, conserva el resto y añade el script sin duplicar la propiedad scripts.

Ahora puedes iniciar el proyecto con:

npm start

8. Estructura básica

Un proyecto pequeño podría tener esta estructura:

mi-proyecto/
├── node_modules/
├── index.js
├── package.json
├── package-lock.json
└── .gitignore

• index.js: archivo principal.
• package.json: configuración, scripts y dependencias.
• package-lock.json: fija las versiones concretas resueltas por npm.
• node_modules/: paquetes instalados.
• .gitignore: especifica qué archivos no deben subirse a Git.

Un .gitignore básico para Node.js:

node_modules/
.env
.env.*
!.env.example

No subas contraseñas, tokens ni archivos .env que contengan secretos al repositorio.

9. Comandos habituales

Comando	Función
npm init -y	Inicializa package.json con valores predeterminados.
node index.js	Ejecuta un archivo JavaScript con Node.js.
npm install	Instala las dependencias del proyecto.
npm install express	Instala Express como dependencia.
npm install -D nodemon	Instala Nodemon como dependencia de desarrollo.
npm start	Ejecuta el script start, si está configurado.
npm run nombre-script	Ejecuta un script definido en package.json.
npm uninstall express	Desinstala Express.

Reiniciar automáticamente durante el desarrollo

Puedes instalar Nodemon:

npm install -D nodemon

Y añadir este script a package.json:

{
  "scripts": {
    "dev": "nodemon index.js"
  }
}

Luego ejecuta:

npm run dev

Nodemon reiniciará el servidor cuando detecte cambios en los archivos que supervisa.

En versiones modernas de Node.js también existe la opción node --watch index.js, que permite reiniciar automáticamente sin instalar Nodemon.

10. Flujo de trabajo resumido

Para iniciar un proyecto nuevo:

mkdir mi-proyecto
cd mi-proyecto
npm init -y

Después, crea index.js y ejecútalo:

node index.js

Para instalar las dependencias de un proyecto existente:

npm install

Para iniciar el servidor, si definiste el script correspondiente:

npm start

Para subir el proyecto a GitHub, recuerda excluir node_modules/ y cualquier archivo con credenciales mediante .gitignore.