Si has trabajado en algún proyecto en Node, o JS en el último tiempo, las posibilidades de haberte topado con un archivo llamado package.json son bastante altas.
¿Qué es el package.json?
De cierta forma, podemos considerar este package.json como un manifiesto de nuestro proyecto.
Históricamente, Node ha trabajado con una herramienta para administrar paquetes llamada npm. Esta herramienta, que normalmente se instala junto con Node, tiene dos roles fundamentales:
Manejar la publicación de un proyecto al registro público de npm (para que otros puedan descargarlo y utilizarlo como dependencia en sus propios proyectos).
Administrar las dependencias de tu proyecto.
Para esto, guarda un registro en un archivo llamado, justamente, package.json.
Dentro de este archivo se definen y manejan características como:
Nombre de tu proyecto.
Versión.
Dependencias.
Repositorio.
Autores.
Licencia.
Y más.
¿Cómo crearlo?
Antes de crear un package.json, hay solo una regla a tener en consideración: El archivo debe ser un JSON de formato válido
Para crearlo, hay 2 formas: hacerlo de forma manual o hacerlo de forma automática:
Si bien es recomendable usar alguno de los asistentes para crear el archivo de forma automática, en caso de que necesitemos hacerlo de forma manual, es solo cosa de crear un archivo llamado package.json en la raíz del proyecto e incluir, como mínimo, la siguiente información:
name.
version.
Todos los demás campos son opcionales, aunque recomendados.
npm init
Dependiendo de cual usemos, el asistente nos hará algunas preguntas para definir la información del proyecto (nombre, version, archivo de entrada, licencia y repositorio entre otros)
Al terminar, tendremos un nuevo y flamante package.json en la raíz del directorio donde hayamos ejecutado el comando.