up-npm

CLI tool written in Go to review and update your NPM dependencies, easy and fast.

Features

• 🔍 Easily identify the update type for each package, whether it's a patch, minor, or major update.
• 📃 Review the release notes for each package to see "what's new" before deciding whether to update.
• 🦘 Selectively skip updates for specific packages.
• 🛡️ Back up your package.json file before updating, ensuring you always have a fallback option if something goes wrong.
• Supports .npmrc _authToken (read more here)

Installation

npm install -g up-npm

Usage

Go where your package.json is located and run:

up-npm

or

up-npm [flags]

Flag	Description
-h, --help	Display help information for up-npm.
--allow-downgrade	Allows downgrading a if latest version is older than current.
--file string	Default package.json.
-f, --filter string	Filter dependencies by package name
--no-dev	Exclude dev dependencies. Default false.
--update-patches	Update patch versions automatically. Default false.
-v, --version	Display the version number for up-npm.

Examples

# Update dependencies
npm-up

# Excluding dev dependencies
npm-up --no-dev

# Update only packages containing "lint"
npm-up --filter lint
npm-up -f lint

# Update some specific .json
npm-up --file my-project/package.json

How to upgrade version

npm install -g up-npm

Build yourself

• Prerequisites:
  • Go 1.20+
  • Node 18+
  • Taskfile
• Then run:

  task buid
  

• Binaries will be created in /dist folder.

.npmrc support

from https://docs.npmjs.com/cli/v10/configuring-npm/npmrc

Detects _authToken inside .npmrc file. The four relevant files are:

• (✅ supported) per-project config file (/path/to/my/project/.npmrc)
• (✅ supported) per-user config file (~/.npmrc)
• (❌ unsupported) global config file ($PREFIX/etc/npmrc)
• (❌ unsupported) npm builtin config file (/path/to/npm/npmrc)

This feature allows to fetch private packages.

Badge

![](https://img.shields.io/badge/up--npm-%20?style=flat&logo=rocket&logoColor=rgb(56%2C%20167%2C%20205)&label=updated%20with&color=rgb(74%2C%20100%2C%20206)&link=https%3A%2F%2Fgithub.com%2FIcaruk%2Fup-npm)