- ¿Qué es npm y por qué lo usamos?
- Verificar si npm está instalado
- Crear un nuevo proyecto con npm
- ¿Qué es el archivo package.json?
- ¿Dónde escribimos nuestro código?
Cuando instalamos Node.js, no solo tenemos acceso al intérprete que entiende JavaScript fuera del navegador. También ganamos una herramienta muy poderosa llamada npm, abreviación de Node Package Manager. Esta herramienta nos ayuda a organizar y automatizar nuestros proyectos de JavaScript.
¿Qué es npm y por qué lo usamos?
npm es un gestor de paquetes. Es como una caja de herramientas que nos permite:- Instalar y actualizar librerías hechas por otras personas (por ejemplo, React, Express, etc.).
- Administrar las dependencias (las librerías externas que necesita nuestro proyecto).
- Automatizar tareas, como correr pruebas o compilar tu código.
- Llevar un control claro de qué usa nuestro proyecto.
Cuando hablamos de un "paquete" en el mundo de npm, nos referimos a cualquier conjunto de archivos que forman un proyecto de JavaScript, ya sea una aplicación web, una API, o una librería.
Verificar si npm está instalado
Después de instalar Node.js, deberíamos tener npm disponible automáticamente. Para asegurarnos, solo tenemos que abrir la terminal (puede ser en VS Code o tu consola favorita) y escribir:
npm --version
Si todo está bien, vas a ver un número de versión, como:
8.19.2
Eso significa que ya podemos usar npm en cualquier proyecto.
Crear un nuevo proyecto con npm
Vamos a crear nuestro primer proyecto paso a paso.
1. Crear una carpeta para el proyecto
Primero, hagamos un directorio donde guardaremos nuestro código.
mkdir codica-hello-world
cd codica-hello-world
2. Inicializar el proyecto con npm
Ahora usamos el comando:
npm init
Este comando nos hará una serie de preguntas (nombre del proyecto, versión, autor...). Podemos presionar Enter en todas para usar los valores por defecto.
Si no queremos responder nada, podemos usar:
npm init -y
Este comando crea automáticamente un archivo llamado package.json con una configuración inicial.
¿Qué es el archivo package.json?
Este es un ejemplo de un archivo package.json:
{
"name": "codica-hello-world",
"version": "1.0.0",
"type": "module",
"description": "",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"author": "",
"license": "ISC"
}
Algunas claves importantes
| Clave | Descripción |
|---|---|
name |
Nombre del proyecto. |
version |
Versión actual. Útil para control de cambios. |
type |
Si es "module", podemos usar import / export. Hay que agregarlo nosotros. |
main |
Archivo principal del proyecto (puede cambiarse si se desea). |
scripts |
Acciones automáticas que podemos correr con npm run. |
import/export), asegúrate de incluir "type": "module" dentro de package.json.
¿Dónde escribimos nuestro código?
Una vez creado el proyecto, veremos el archivo package.json, pero el código de nuestra aplicación va a ir principalmente en un archivo index.js.
Crea un archivo llamado index.js (en la misma carpeta del proyecto) y escribe el siguiente código:
// Este mensaje aparecerá en la terminal cuando ejecutemos el proyecto
console.log("¡Hola, Códica!");
Para ejecutar el código, usamos:
node index.js
Y veremos la salida:
¡Hola, Códica!
Resumen
- Node.js incluye automáticamente
npm. - Puedes verificar que tienes
npminstalado connpm --version. - Para iniciar un nuevo proyecto, usamos
npm init(onpm init -y). - El archivo
package.jsonguarda la configuración del proyecto. - Agrega
"type": "module"enpackage.jsonsi quieres usarimport/export. - El archivo principal del proyecto es
index.js.
Ahora que ya sabes cómo empezar un proyecto con npm, en próximas lecciones veremos cómo instalar paquetes y crear scripts personalizados para automatizar tareas comunes. ¡Vamos paso a paso!
Trabajo independiente
Inicializa el proyecto con npm
1️⃣ En la terminal, asegúrate de estar dentro de la carpeta del proyecto (codica-js) y ejecuta:
npm init -y
Este comando crea automáticamente un archivo package.json con información básica sobre tu proyecto.
2️⃣ Abre el archivo package.json en tu editor de código (por ejemplo, VS Code) y reemplaza su contenido por este:
{
"name": "codica-js",
"version": "1.0.0",
"description": "Mi primer proyecto en Códica",
"main": "index.js",
"type": "module",
"scripts": {
"start": "node index.js"
},
"author": "Tu Nombre",
"license": "MIT"
}
3️⃣ Asegúrate de tener un archivo index.js con el siguiente contenido:
console.log("¡Hola, Códica!");
4️⃣ Ejecuta tu archivo con el comando:
npm start
Deberías ver este mensaje en la terminal:
¡Hola, Códica!
5️⃣ Sube los cambios a GitHub:
🔸 Agrega todos los archivos al control de versiones:
git add .
🔸 Haz un commit con un mensaje descriptivo:
git commit -m "Inicialización del proyecto con package.json y ejecución de index.js"
🔸 Envía los cambios a GitHub:
git push origin main
✅ Este proyecto lo vas a seguir usando en las próximas lecciones. ¡No borres nada! Al final estará listo y con buenas prácticas de desarrollo.
Materiales adicionales
Para acceder completo a curso necesitas un plan básico
El plan básico te dará acceso completo a todos los cursos, ejercicios y lecciones de Códica, proyectos y acceso de por vida a la teoría de las lecciones completadas. La suscripción se puede cancelar en cualquier momento.
