• Stars
    star
    4,315
  • Rank 9,403 (Top 0.2 %)
  • Language
  • License
    Creative Commons ...
  • Created about 8 years ago
  • Updated 8 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Awesome npm resources and tips

Awesome npm Awesome npm

Awesome npm resources and tips

npm is a package manager for the JavaScript programming language and comes bundled in the Node.js runtime.

Please read the contribution guidelines before contributing.

Contents

Articles

Tools

Web

Browser extensions

  • Octo-Linker - Chrome extension to navigate across npm packages on GitHub with ease.
  • npm-hub - Chrome extension to explore npm dependencies on GitHub repos.
  • github-npm-stats - View npm download stats on GitHub.
  • npm-search-update - Chrome extension to quickly search for dependencies and monitor changes from the npm registry.

CLI

Packages

Publishing

  • np - A better npm publish.
  • publish-please - Publish packages safely and gracefully.
  • npm-release - Making releasing to npm so easy a kitten could probably do it™.
  • pkgfiles - List all files which would be published in a package.
  • release-it - Automate releases for Git repositories and/or npm packages. Changelog generation, GitHub/GitLab releases, etc.
  • semantic-release - Fully automated package publishing.

Registry

  • npm-name - Check whether a package name is available on npm.
  • package-json - Get the package.json of a package from the npm registry.
  • latest-version - Get the latest version of an npm package.
  • npm-keyword - Get a list of npm packages with a certain keyword.
  • npm-user - Get user info of an npm user.
  • npm-email - Get the email of an npm user.
  • npm-user-packages - Get packages by an npm user.
  • dpn - Get the dependents of a user's npm packages.
  • npm-stats - Get data from an npm registry.
  • npm-cli-login - Log in to npm.
  • nrm - Registry manager.
  • npm-register - Easy to set up and maintain npm registry and proxy.
  • verdaccio - Lightweight private npm proxy registry.
  • cloudsmith - A fully managed package management SaaS with support for public and private npm registries (and many others).

Other

  • npm-home - Open the npm page of a package.
  • gh-home - Open the GitHub page of a package.
  • david - Check if your package dependencies are out of date.
  • npm-check - Check for outdated, incorrect, and unused dependencies, as well as interactive update.
  • npm-upgrade - Update outdated npm dependencies interactively.
  • npm-shrinkwrap - A consistent shrinkwrap tool.
  • npm-windows-upgrade - Upgrade npm on Windows.
  • generator-nm - Scaffold out an npm package.
  • pkg-up - Find the closest package.json file.
  • read-pkg-up - Read the closest package.json file.
  • normalize-package-data - Normalize package metadata.
  • pkg-conf - Get namespaced config from the closest package.json.
  • npm-run-path - Run locally installed binaries in the terminal by name like with global ones.
  • local-npm - Use npm offline.
  • npe - CLI for inspecting and editing properties in package.json.
  • engine-deps - Manage Node.js version specific dependencies with ease.
  • enpeem-search - Search packages by scraping the npm web search.
  • npm-issues - Search known issues of all your packages at once.
  • john - Make npm3's flat dependencies easier to find and sort.
  • ntl - Interactive CLI menu to list & run npm tasks.
  • decheck - Explore dependencies of npm packages in the command-line.
  • shrinkpack - Lock down your dependencies and install offline.
  • redrun - Expand scripts from package.json to improve execution speed.
  • package-size - Get the bundle size of an npm package.
  • synp - Convert yarn.lock to package-lock.json and vice versa.
  • npm-run-all - CLI tool to run multiple npm-scripts in parallel or serial.
  • onchange - Watch files and folders and run a command when something changed.
  • cli-error-notifier - Sends native desktop notifications when npm scripts fail.
  • luna - App to manage npm dependencies.
  • emma-cli - Interactive CLI package search utility.
  • lockfile-lint - Lint lockfiles for improved security and trust policies to mitigate malicious package injection and insecure lockfile resources.

Clients

  • yarn - Fast, reliable, and secure dependency management.
  • npm - The official client.
  • pnpm - Fast, disk space efficient package manager.

Tips

Update to the latest npm version

$ npm install --global npm

Windows users, read more.

Command aliases

  • npm i npm install
  • npm i -Dnpm install --save-dev
  • npm tnpm test
  • npm itnpm install && npm test
  • npm rnpm uninstall
  • npm unnpm uninstall
  • npm upnpm update

Shell aliases

Speed up your common npm tasks.

In your .zshrc/.bashrc:

alias ni='npm install'
alias nid='npm install --save-dev'
alias nig='npm install --global'
alias nt='npm test'
alias nit='npm install && npm test'
alias nk='npm link'
alias nr='npm run'
alias ns='npm start'
alias nf='npm cache clean && rm -rf node_modules && npm install'
alias nlg='npm list --global --depth=0'

Don't add to package.json when installing

By default npm adds packages you install to the dependencies field in package.json (since v5). You can prevent this by specifying the --no-save flag. You can add a package to devDependencies with --save-dev/-D:

$ npm install --save-dev ava

Run scripts

You can easily run scripts using npm by adding them to the "scripts" field in package.json and run them with npm run <script-name>. Run npm run to see available scripts. Binaries of locally install packages are made available in the PATH, so you can run them by name.

{
	"name": "awesome-package",
	"scripts": {
		"cat": "cat-names"
	},
	"dependencies": {
		"cat-names": "^1.0.0"
	}
}
$ npm run cat
Max

All package.json properties are exposed as environment variables:

{
	"name": "awesome-package",
	"scripts": {
		"name": "echo $npm_package_name"
	}
}
$ npm run name
awesome-package

Passing options to commands

You can pass options to the command you are using in your npm script by adding -- --flag like in the example below. The -- marks the end of options parsing, so npm run will just ignore it and pass it to the command.

{
	"name": "awesome-package",
	"scripts": {
		"xo": "xo",
		"xo:fix": "npm run xo -- --fix",
	}
}

Adding the -- --fix option is like executing xo --fix.

Silent option

npm run has a --silent option which is especially useful when combining npm scripts.

Imagine you have a setup for linting your JavaScript files like the following:

{
	"name": "awesome-package",
	"scripts": {
		"xo": "xo",
		"xo:fix": "npm run xo --silent -- --fix",
	}
}

Using the --silent option reduces the output in the terminal. See this comparison.

Lifecycle scripts

npm comes with predefined lifecyle scripts which are excuted under specific conditions if they are defined in your package.json.

{
	"name": "awesome-package",
	"scripts": {
		"prepublishOnly": "nsp check"
	},
	"devDependencies": {
		"nsp": "^3.0.0"
	}
}

This will be executed automatically before your npm package is published to the registry via npm publish to check for known vulnerabilties in your dependencies.

Note: prepublishOnly is available since npm v4.0.0. See npm docs.

npm start and npm test

npm start and npm test are also lifecycle scripts but are not executed automatically.

{
	"name": "awesome-package",
	"scripts": {
		"start": "node server.js",
		"test": "ava"
	},
	"devDependencies": {
		"ava": "^1.0.0"
	}
}

Therefore they can be executed simply with:

$ npm test
$ npm start

pre and post scripts

These are special lifecycle scripts which can be used to run scripts automatically in sequence.

{
	"name": "awesome-package",
	"scripts": {
		"pretest": "eslint .",
		"test": "ava"
	},
	"devDependencies": {
		"eslint": "^4.19.0",
		"ava": "^1.0.0"
	}
}
$ npm test

This will lint your files before running your tests. The tests will not run if linting fails. Or more generally spoken: the following script won’t be executed if one of the scripts running in sequence exits with an exit code other than 0.

Note: pre and post scripts can also be used for your custom npm scripts. So npm run foo will also run prefoo and postfoo if defined.

Run script with npx

npm comes bundled with npx (Since v5.2.0) — a tool to execute package binaries. Each command is executed either from the local node_modules/.bin directory, or from a central cache, installing any packages needed in order for <command> to run.

{
	"name": "awesome-package",
	"dependencies": {
		"cat-names": "^1.0.0"
	}
}

If the binary is already installed, it will be executed from node_modules/.bin.

$ npx cat-names
Max

But if the binary is missing, it will be installed first.

$ npx dog-names
npx: installed 46 in 3.136s
Bentley

Run commands with different Node.js versions

With npx (Comes bundled with npm v5.2.0 or newer) and the node-bin package, you can easily try out code in different Node.js versions without having to use a version manager like nvm, nave, or n.

$ npx [email protected] -- node --version
v6.11.0

Link local packages

Sometimes it can be useful to have a local version of a package as a dependency. You can use npm link to link one local package into another. Run npm link in the package you want to use. This creates a global reference. Then go into your original package and run npm link <package-name> to link in the other package.

$ cd rainbow
$ npm link
$ cd ../unicorn
$ npm link rainbow

You can now use rainbow as a dependency in the unicorn package.

Install a package from GitHub

npm supports using a shorthand for installing a package directly from a GitHub repo:

$ npm install sindresorhus/chalk

Let's target a specific commit as the main branch is a moving target:

$ npm install 'sindresorhus/chalk#51b8f32'

Specify either a commit SHA, branch, tag, or nothing.

You can also install Git dependencies with semver: (Requires npm v5 or newer)

$ npm install 'sindresorhus/chalk#semver:^2.0.0'

Install a specific version of a package

$ npm install [email protected]

List top-level installed packages and their version

$ npm ls --depth=0

Command help

Get help docs for a command:

$ npm help <command>

Example:

$ npm help install

Standalone version of a package

Quickly get a standalone version of a package that is browserified and usable in the browser.

https://wzrd.in/standalone/<package-name>[@<version>]

Examples:

Great for prototyping, but download the file or use Browserify yourself for production.

FAQ

Community

Documentation

Support

Related

More Repositories

1

awesome

😎 Awesome lists about all kinds of interesting topics
270,042
star
2

awesome-nodejs

⚡ Delightful Node.js packages and resources
52,854
star
3

awesome-electron

Useful resources for creating apps with Electron
25,164
star
4

quick-look-plugins

List of useful Quick Look plugins for developers
17,497
star
5

got

🌐 Human-friendly and powerful HTTP request library for Node.js
TypeScript
13,714
star
6

type-fest

A collection of essential TypeScript types
TypeScript
12,930
star
7

pure

Pretty, minimal and fast ZSH prompt
Shell
12,391
star
8

ky

🌳 Tiny & elegant JavaScript HTTP client based on the browser Fetch API
TypeScript
11,367
star
9

pageres

Capture website screenshots
TypeScript
9,573
star
10

ora

Elegant terminal spinner
JavaScript
8,591
star
11

github-markdown-css

The minimal amount of CSS to replicate the GitHub Markdown style
CSS
7,421
star
12

np

A better `npm publish`
JavaScript
7,395
star
13

screenfull

Simple wrapper for cross-browser usage of the JavaScript Fullscreen API
HTML
6,891
star
14

caprine

Elegant Facebook Messenger desktop app
TypeScript
6,816
star
15

Gifski

🌈 Convert videos to high-quality GIFs on your Mac
Swift
6,807
star
16

fkill-cli

Fabulously kill processes. Cross-platform.
JavaScript
6,782
star
17

query-string

Parse and stringify URL query strings
JavaScript
6,453
star
18

execa

Process execution for humans
JavaScript
6,019
star
19

modern-normalize

🐒 Normalize browsers' default style
TypeScript
5,038
star
20

css-in-readme-like-wat

Style your readme using CSS with this simple trick
5,013
star
21

promise-fun

Promise packages, patterns, chat, and tutorials
4,277
star
22

electron-store

Simple data persistence for your Electron app or module - Save and load user preferences, app state, cache, etc
JavaScript
4,165
star
23

awesome-scifi

Sci-Fi worth consuming
4,057
star
24

create-dmg

Create a good-looking DMG for your macOS app in seconds
JavaScript
3,950
star
25

speed-test

Test your internet connection speed and ping using speedtest.net from the CLI
JavaScript
3,882
star
26

ow

Function argument validation for humans
TypeScript
3,779
star
27

eslint-plugin-unicorn

More than 100 powerful ESLint rules
JavaScript
3,765
star
28

file-type

Detect the file type of a Buffer/Uint8Array/ArrayBuffer
JavaScript
3,438
star
29

meow

🐈 CLI app helper
JavaScript
3,305
star
30

p-queue

Promise queue with concurrency control
TypeScript
3,202
star
31

open

Open stuff like URLs, files, executables. Cross-platform.
JavaScript
2,976
star
32

Plash

💦 Make any website your Mac desktop wallpaper
Swift
2,735
star
33

alfy

Create Alfred workflows with ease
JavaScript
2,570
star
34

trash

Move files and directories to the trash
JavaScript
2,512
star
35

fast-cli

Test your download and upload speed using fast.com
JavaScript
2,484
star
36

guides

A collection of succinct guides - Public Domain
2,424
star
37

globby

User-friendly glob matching
JavaScript
2,376
star
38

slugify

Slugify a string
JavaScript
2,357
star
39

emoj

Find relevant emoji from text on the command-line 😮 ✨ 🙌 🐴 💥 🙈
JavaScript
2,311
star
40

cli-spinners

Spinners for use in the terminal
JavaScript
2,255
star
41

on-change

Watch an object or array for changes
JavaScript
1,946
star
42

devtools-detect

Detect if DevTools is open and its orientation
HTML
1,924
star
43

touch-bar-simulator

Use the Touch Bar on any Mac
Swift
1,892
star
44

gulp-imagemin

Minify PNG, JPEG, GIF and SVG images
JavaScript
1,888
star
45

notifier-for-github

Browser extension - Get notified about new GitHub notifications
JavaScript
1,760
star
46

editorconfig-sublime

Sublime Text plugin for EditorConfig - Helps developers maintain consistent coding styles between different editors
Python
1,757
star
47

capture-website

Capture screenshots of websites
JavaScript
1,670
star
48

emittery

Simple and modern async event emitter
JavaScript
1,664
star
49

Defaults

💾 Swifty and modern UserDefaults
Swift
1,661
star
50

electron-boilerplate

Boilerplate to kickstart creating an app with Electron
JavaScript
1,632
star
51

pageres-cli

Capture website screenshots
JavaScript
1,620
star
52

is

Type check values
TypeScript
1,605
star
53

clipboardy

Access the system clipboard (copy/paste)
JavaScript
1,598
star
54

gulp-rev

Static asset revisioning by appending content hash to filenames: `unicorn.css` → `unicorn-d41d8cd98f.css`
JavaScript
1,538
star
55

pify

Promisify a callback-style function
JavaScript
1,494
star
56

boxen

Create boxes in the terminal
JavaScript
1,458
star
57

Actions

⚙️ Supercharge your shortcuts
Swift
1,437
star
58

multiline

Multiline strings in JavaScript
JavaScript
1,424
star
59

hyper-snazzy

Elegant Hyper theme with bright colors
JavaScript
1,412
star
60

amas

Awesome & Marvelous Amas
1,392
star
61

LaunchAtLogin

Add “Launch at Login” functionality to your macOS app in seconds
Swift
1,346
star
62

refined-twitter

Browser extension that simplifies the Twitter interface and adds useful features
JavaScript
1,313
star
63

KeyboardShortcuts

⌨️ Add user-customizable global keyboard shortcuts (hotkeys) to your macOS app in minutes
Swift
1,313
star
64

iterm2-snazzy

Elegant iTerm2 theme with bright colors
1,313
star
65

del

Delete files and directories
JavaScript
1,305
star
66

electron-context-menu

Context menu for your Electron app
JavaScript
1,297
star
67

p-limit

Run multiple promise-returning & async functions with limited concurrency
JavaScript
1,294
star
68

Settings

⚙ Add a settings window to your macOS app in minutes
Swift
1,282
star
69

trash-cli

Move files and folders to the trash
JavaScript
1,244
star
70

electron-util

Useful utilities for Electron apps and modules
JavaScript
1,188
star
71

is-online

Check if the internet connection is up
JavaScript
1,181
star
72

ponyfill

🦄 Like polyfill but with pony pureness
1,136
star
73

conf

Simple config handling for your app or module
TypeScript
1,109
star
74

anatine

[DEPRECATED] 🐦 Pristine Twitter app
JavaScript
1,097
star
75

electron-dl

Simplified file downloads for your Electron app
JavaScript
1,087
star
76

log-update

Log by overwriting the previous output in the terminal. Useful for rendering progress bars, animations, etc.
JavaScript
1,027
star
77

pretty-bytes

Convert bytes to a human readable string: 1337 → 1.34 kB
JavaScript
1,022
star
78

grunt-sass

Compile Sass to CSS
JavaScript
1,020
star
79

mem

Memoize functions - an optimization technique used to speed up consecutive function calls by caching the result of calls with identical input
TypeScript
1,019
star
80

DockProgress

Show progress in your app's Dock icon
Swift
1,003
star
81

wallpaper

Manage the desktop wallpaper
JavaScript
996
star
82

p-map

Map over promises concurrently
JavaScript
996
star
83

public-ip

Get your public IP address - very fast!
JavaScript
979
star
84

gulp-app

[DEPRECATED] Gulp as an app
JavaScript
961
star
85

grunt-shell

Run shell commands
JavaScript
952
star
86

load-grunt-tasks

Load multiple grunt tasks using globbing patterns
JavaScript
940
star
87

hasha

Hashing made simple. Get the hash of a buffer/string/stream/file.
JavaScript
934
star
88

pretty-ms

Convert milliseconds to a human readable string: `1337000000` → `15d 11h 23m 20s`
JavaScript
929
star
89

terminal-image

Display images in the terminal
JavaScript
923
star
90

object-assign

ES2015 Object.assign() ponyfill
JavaScript
919
star
91

copy-text-to-clipboard

Copy text to the clipboard in modern browsers (0.2 kB)
JavaScript
858
star
92

System-Color-Picker

🎨 The macOS color picker as an app with more features
Swift
842
star
93

get-port

Get an available TCP port
JavaScript
817
star
94

atom-editorconfig

Helps developers maintain consistent coding styles between different editors
JavaScript
815
star
95

normalize-url

Normalize a URL
JavaScript
807
star
96

grunt-concurrent

Run grunt tasks concurrently
JavaScript
799
star
97

dot-prop

Get, set, or delete a property from a nested object using a dot path
JavaScript
777
star
98

p-progress

Create a promise that reports progress
TypeScript
751
star
99

gulp-changed

Only pass through changed files
JavaScript
747
star
100

generator-nm

Scaffold out a node module
JavaScript
742
star