El package.json

Es probablemente el archivo más importante de cualquier proyecto de JavaScript / Node.js.

Es el carnet de identidad y manual de instrucciones de un proyecto de Node. Guarda toda la información relevante sobre el código: su nombre, versión, los comandos que puedes ejecutar y qué librerías o dependencias externas necesita para funcionar. (JSON no admite comentarios, es a título informativo).

Ejemplo de contenido del package.json:

La especificación oficial y completa del archivo package.json está documentada por el equipo de npm. La URL oficial de la documentación es: https://docs.npmjs.com/cli/v10/configuring-npm/package-json

¿Dónde se ubica?

En la raíz del proyecto.

Secciones clave

Datos básicos del proyecto:

• "name": El nombre del proyecto en minúsculas y sin espacios (ej: "mi-sitio-astro").
• "version": La versión actual de tu proyecto (ej: "1.0.0").
• "type": "module": En proyectos de Astro, esta línea le dice a Node.js que trate todo el proyecto usando código moderno de módulos ESM (import / export).

"scripts" (Comandos de la terminal):

Son accesos directos a comandos que ejecutas desde la consola mediante pnpm run [nombre] o pnpm [nombre].

"dependencies" (Dependencias de Producción)

Son las librerías externas que el sitio web necesita para funcionar en producción.

"devDependencies" (Dependencias de Desarrollo)

¿Se sube a Git y al Hosting?

A Git / GitHub: SÍ. SIEMPRE

Sin este archivo, nadie puede saber qué librerías instalar ni cómo ejecutar el proyecto.

Al Hosting: SÍ, SIEMPRE

Servidores como Vercel, Netlify o Cloudflare Pages leen tu package.json para saber qué comando ejecutar para construir la web (normalmente npm run build / pnpm build) y qué paquetes tienen que instalar.