Crea un proyecto
Configura un proyecto real de Node.js desde cero
⏱ Estim. ~9 min
01 · Leer
Cada pieza de software que usaste — desde apps móviles hasta sitios web enormes — empezó así: alguien creó una carpeta vacía y configuró un proyecto dentro. Eso es justo lo que vas a hacer ahora.
Configurar un proyecto bien desde el inicio te ahorra muchísimos dolores de cabeza después. Un proyecto en Node.js no es nada especial — es solo una carpeta con un archivo de configuración package.json que registra el nombre, la versión y las dependencias del proyecto. Sin ese archivo, herramientas como npm ni siquiera saben qué necesita tu proyecto ni cómo correrlo.
Piénsalo como mudarte a un departamento nuevo. Antes de decorar o invitar a tus amigos, tienes que firmar el contrato y recibir las llaves. npm init es como firmar el contrato — crea el documento oficial (package.json) que dice 'esta carpeta es un proyecto real'.
💡 Imagínalo asíEmpezar un proyecto es como mudarte a un departamento nuevo. Antes de decorar o construir nada, primero tienes que firmar el contrato (npm init) y recibir el documento oficial que lo hace válido (package.json).
Puntos clave
- Cada proyecto de Node.js empieza con una carpeta y un package.json
- package.json registra la identidad y las dependencias del proyecto
- Configúralo bien desde el inicio para que el proyecto no se desordene al crecer
02 · Práctica real
Cada proyecto empieza con una carpeta. Crea una llamada my-server y entra ahí. Estos dos comandos crean el directorio y se mueven dentro.
mkdir my-server && cd my-server
03 · Práctica real
Ahora inicializa tu proyecto con npm. El flag -y significa 'usar todo por defecto' — se salta las preguntas y crea el archivo de configuración directo.
npm init -y
04 · Quiz
¿Qué hace el flag -y en npm init -y?
- Instala la última versión de npm
- Crea un archivo yarn.lock
- Se salta todas las preguntas y usa los valores por defecto
- Yes, borra archivos existentes
05 · Práctica real
Vamos a ver qué creó npm. package.json es el corazón de cada proyecto de Node.js — describe tu proyecto y lleva un registro de las dependencias.
cat package.json
06 · Completar
El archivo que lleva el registro de las dependencias de tu proyecto se llama _____.
07 · Leer
Qué significa cada campo de package.json:- name — el nombre de tu proyecto (por defecto, el nombre de la carpeta) - version — el número de versión del proyecto (empieza en 1.0.0) - description — una descripción corta de lo que hace - main — el archivo de entrada (el que se ejecuta cuando alguien importa tu proyecto) - scripts — comandos personalizados que puedes correr con npm run <name> - keywords — etiquetas de búsqueda cuando publicas en npm - license — cómo otros pueden usar tu código
El campo más importante que vas a usar pronto es dependencies — ahí se listan todos los paquetes que tu proyecto necesita. Ahora está vacío porque todavía no instalamos nada.
Puntos clave
- package.json es el archivo de configuración de cada proyecto de Node.js
- npm init -y lo crea con valores por defecto sensatos
- El campo dependencies registra los paquetes que usa tu proyecto
08 · Quiz
Intentas correr npm install express, pero te da un error diciendo que no hay package.json. ¿Qué deberías hacer primero?
- Reinstalar Node.js
- Crear manualmente un archivo llamado express.js
- Correr node install express en su lugar
- Correr npm init -y para crear el archivo package.json
Otras lecciones de este capítulo
⚠ La experiencia interactiva completa necesita JavaScript. Actívalo y vuelve a cargar la página.
※ Este es un proyecto educativo independiente — no es un producto oficial de Anthropic. Claude™ es una marca registrada de Anthropic, PBC.