Solución: npm ERR! missing script — el script no existe en package.json

Paso 1 — Ver qué scripts están disponibles:

npm run
# Lista todos los scripts definidos en package.json

Paso 2 — Verificar el package.json:

// package.json
{
  "scripts": {
    "dev": "vite",           // ← npm run dev
    "build": "vite build",   // ← npm run build
    "preview": "vite preview"
  }
}

Caso — estás en el directorio equivocado:

# Asegúrate de estar en la carpeta raíz del proyecto
ls package.json   # Mac/Linux
dir package.json  # Windows
# Si el proyecto tiene subcarpetas con sus propios package.json:
cd frontend && npm run dev

Caso — necesitas añadir el script que falta:

// Añade el script en package.json según tu stack:
// Vite
"scripts": {
  "dev": "vite",
  "build": "vite build",
  "start": "vite preview"
}
// Next.js
"scripts": {
  "dev": "next dev",
  "build": "next build",
  "start": "next start"
}
// Express / Node.js
"scripts": {
  "start": "node server.js",
  "dev": "nodemon server.js"
}
// Astro
"scripts": {
  "dev": "astro dev",
  "build": "astro build",
  "preview": "astro preview"
}

npm start vs npm run start:

# npm start es un atajo especial — equivale a npm run start
# Solo funciona si tienes "start" en scripts
# Para cualquier otro nombre debes usar npm run:
npm run dev       # ✅
npm dev           # ❌ no es un atajo válido

Si acabas de clonar el repo:

# Instala dependencias primero (siempre antes de npm run)
npm install
npm run dev