Как пользоваться: Генератор package.json
- Укажите имя пакета и версию. Имя проверяется по правилам именования npm прямо во время ввода.
- Выберите набор скриптов (Node, Vite, Next.js, TypeScript-библиотека) и тип модулей.
- Добавьте лицензию, автора, репозиторий и версию Node.js, которую поддерживает ваш код.
- Скопируйте или скачайте файл в корень проекта и выполните
npm install, чтобы установить зависимости.
Самые важные поля package.json
| Поле | Назначение |
|---|---|
name | Имя пакета: строчные буквы, не более 214 символов, безопасные для URL, может быть с областью видимости (@org/name) |
version | Семантическая версия, например 1.4.2 |
type | "module" делает файлы .js ES-модулями (import). По умолчанию используется CommonJS |
main / exports | Точки входа, которые импортирует другой код. exports также скрывает внутренние файлы |
scripts | Команды для npm run dev, build, test и других |
engines | Версии Node.js, которые поддерживает ваш код |
private | true защищает от случайной публикации через npm publish |
packageManager | Закрепляет npm, pnpm или Yarn через Corepack |
Зависимости добавляет менеджер пакетов
Не вписывайте версии зависимостей вручную. Выполните npm install react или npm install -D vite, и npm сам запишет их с нужным диапазоном версий (обычно ^). Закоммитьте lock-файл, чтобы у всех устанавливались одинаковые версии.
Что сделать дальше в новом проекте
Добавьте .gitignore (как минимум node_modules/ и .env), .editorconfig, README и рабочий процесс GitHub Actions, который запускает скрипты test и build при каждом push.
Также ищут как: npm init, exports package.json, package.json для node, правила имени npm пакета, package.json type module.
Инструменты, которые хорошо сочетаются с Генератор package.json
- JSON форматтер — Вставьте JSON, чтобы отформатировать, минифицировать или проверить его.
- Валидатор YAML — Вставьте файл Docker Compose, манифест Kubernetes, workflow GitHub Actions или любой YAML, чтобы найти ошибку, поймать типичные ловушки и получить аккуратно отформатированную версию.
- Генератор YAML для Kubernetes — Укажите имя приложения, образ и порт, и вы получите готовый к продакшену YAML для Kubernetes: Deployment с пробами, лимитами ресурсов и защищённым security context, а также выбранные вами Service, Ingress с TLS, ConfigMap, Secret и HorizontalPodAutoscaler — всё в одном файле, готовом для kubectl apply.
- Генератор systemd service — Запускайте приложение как полноценный сервис Linux, который стартует при загрузке и перезапускается после сбоя.
Часто задаваемые вопросы
Какие правила для имён npm-пакетов?
Только строчные буквы, без пробелов, не более 214 символов. Имя не может начинаться с точки или подчёркивания. Допустимы только безопасные для URL символы (буквы, цифры, - . _ ~). Имя не должно совпадать со встроенным модулем Node.js, например http. Имена с областью видимости выглядят так: @scope/name.
Нужно ли использовать "type": "module"?
Для новых проектов — да. ES-модули являются стандартом, работают в Node.js 18+, Vite и большинстве инструментов. CommonJS стоит использовать, только если вы зависите от инструментов, которым нужен require().
Что делает "private": true?
Оно запрещает npm публиковать пакет. Это защищает приложения и внутренние проекты от случайной публикации.
Куда попадают зависимости?
Устанавливайте их через npm, pnpm или Yarn. Инструмент сам запишет их в dependencies или devDependencies.
Можно ли установить Генератор package.json как веб-приложение и пользоваться им офлайн?
Да. Генератор package.json — это веб-приложение (PWA), которое можно установить из браузера, без скачивания из магазина приложений. В Chrome или Edge (Windows, macOS, Linux, ChromeOS) или на Android нажмите вверху этой страницы «Установить приложение»; на iPhone и iPad используйте «Поделиться → На экран «Домой»», а в Safari 17+ на Mac — «Файл → Добавить в Dock». После этого приложение откроется в отдельном окне со своим значком, и так как оно полностью работает в браузере, оно продолжит работать офлайн. Firefox на компьютере не умеет устанавливать веб-приложения. Как работает установка.