Секреты package.json

package.json — это сердце любого Node.js проекта. Если его правильно использовать, жизнь фронтендера становится проще.

Зачем нужен package.json:

• Хранит информацию о проекте (название, версия, автор).
• Управляет зависимостями (dependencies и devDependencies).
• Позволяет создавать удобные команды через scripts.

Главные поля:

1. name и version — имя проекта и его версия.
2. scripts — команды, которые можно запускать через npm run <название>.

"scripts": {
  "start": "node index.js",
  "build": "webpack --mode production",
  "dev": "webpack --mode development --watch"
}

1. npm run start — запуск проекта
2. npm run build — сборка проекта
3. npm run dev — запуск в режиме разработки
4. dependencies — библиотеки, которые нужны проекту в продакшене (например, React, Express).
5. devDependencies — библиотеки для разработки (Webpack, ESLint, Jest).

Советы для порядка в package.json:

• Разделяй зависимости на dependencies и devDependencies.
• Пиши короткие скрипты, чтобы не копипастить длинные команды в терминале.
• Используй npm install <пакет> --save-dev для devDependencies.
• Добавляй engines для указания версии Node и npm, чтобы команда не столкнулась с конфликтами:

"engines": {
  "node": ">=20",
  "npm": ">=9"
}

💡 Секрет: package.json можно использовать как мини-автоматизацию. Любые рутинные команды проекта лучше запускать через скрипты — так новые участники команды легко стартуют с первого раза.