commit 38f57228965c7e3f8f9ad955dce155b98332e047 Author: Isidoro Nevares Martín Date: Fri Mar 13 13:08:48 2026 +0100 Commit inicial diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..3ec544c --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +node_modules/ +.env \ No newline at end of file diff --git a/.vscode/launch.json b/.vscode/launch.json new file mode 100644 index 0000000..ba388a7 --- /dev/null +++ b/.vscode/launch.json @@ -0,0 +1,11 @@ +{ + "version": "0.2.0", + "configurations": [ + { + "type": "node", + "request": "launch", + "name": "Iniciar app.js", + "program": "${workspaceFolder}/app.js" + } + ] +} \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..23c67fa --- /dev/null +++ b/README.md @@ -0,0 +1,129 @@ +# npm – Resumen rápido + +## ¿Qué es npm? + +**npm** (Node Package Manager) es la herramienta de gestión de paquetes y automatización de proyectos para Node.js. + +Permite instalar librerías, ejecutar scripts y gestionar dependencias de forma automática. Todo se configura mediante un archivo central llamado `package.json`. + +--- + +## Conceptos básicos + +### `package.json` + +Es el archivo principal donde se define: + +- Información del proyecto (`name`, `version`, `description`) +- Dependencias (`dependencies` y `devDependencies`) +- Scripts de ejecución +- Configuración de compilación o herramientas adicionales + +**Ejemplo básico:** + +```json +{ + "name": "mi-proyecto", + "version": "1.0.0", + "description": "Proyecto de ejemplo" +} +``` + +--- + +### Dependencias + +Las librerías necesarias para el proyecto se declaran en `package.json`: + +- `"dependencies"` → necesarias para **ejecución** +- `"devDependencies"` → necesarias solo para **desarrollo** + +**Ejemplo:** + +```json +"dependencies": { + "express": "^5.2.1", + "mysql2": "^3.19.1" +} +``` + +Para instalarlas se ejecuta: + +```bash +npm install +``` + +> npm descargará automáticamente las librerías en la carpeta `node_modules`. + +--- + +### Scripts npm + +Los scripts permiten automatizar tareas comunes, como ejecutar la aplicación, tests o compilaciones. + +**Ejemplo en `package.json`:** + +```json +"scripts": { + "start": "node app.js", + "dev": "node app.js", + "test": "echo \"Error: no test specified\" && exit 1" +} +``` + +Se ejecutan con: + +```bash +npm run start # o simplemente: npm start +npm run dev # para desarrollo +npm run test # ejecutar tests +``` + +--- + +## Ciclo de vida / tareas comunes + +| Comando | Función | +|---|---| +| `npm install` | Instala las dependencias | +| `npm start` | Ejecuta la aplicación | +| `npm run