Awesome Npm Scripts Overview

Everything awesome related to npm scripts and using npm as a build tool.

🏠 Home · 🔥 Feed · 📮 Subscribe · ❤️ Sponsor · 😺 RyanZim/awesome-npm-scripts · ⭐ 678 · 🏷️ Programming Languages

[ Daily / Weekly / Overview ]

Awesome npm Scripts

Everything awesome for using npm as a build tool.

You might also like awesome-npm (⭐4.1k).

Notice: I'm currently too busy to actively expand this list; therefore, I've decided to make this an OPEN Open Source Project. Individuals making significant and valuable contributions are given commit-access to the project to contribute as they see fit.

Contents

• Articles
• Videos/Talks
• Task Runners
• File Watchers
• Dev Servers
• Cross-platform Utilities
  • Utility Packs
• Other Utilities
• Miscellaneous
• Cross-platform Shell Reference
• npm run Reference

Articles

• Why we should stop using Grunt & Gulp - Blog post by Keith Cirkel.
• How to Use npm as a Build Tool - Sequel to »Why we should stop using Grunt & Gulp«.
• Why I Left Gulp and Grunt for npm Scripts - Article by Cory House.
• Helpers and tips for npm run scripts - Blog post by Michael Kühnel covering advanced topics.
• Running cross-platform tasks via npm package scripts - The most comprehensive guide to using npm Scripts by Dr. Axel Rauschmayer.

Videos/Talks

• Advanced front-end automation with npm scripts - Talk at Nordic.js 2015 by Kate Hudson.
• How to create a build system with npm scripts - Video tutorial series on setting up a front-end build system.

Task Runners

Tools for running multiple commands or npm scripts in parallel or sequentially.

• script-runner (⭐25) - Simple task runner with a terse syntax.
• npm-run-all (⭐5k) - Fully featured task runner.
• redrun (⭐110) - Expand scripts from package.json to improve execution speed.

File Watchers

Tools to watch your source files and run a build command whenever any of the files change.

• onchange (⭐775) - onchange <glob> -- <command>.
• watch (⭐1.2k) - watch <command> <directory>.

Dev Servers

• http-server (⭐12k) - Simple zero-configuration command-line http server.
• live-server (⭐4k) - Simple development http server with live reload capability.

Cross-platform Utilities

Utilities to perform common command-line tasks without worrying about cross-platform compatibility.

• rimraf (⭐4.9k) - Delete files or directories; like rm -rf.
• del-cli (⭐265) - Safer file and folder deletion.
• mkdirp - Create a directory, creating parent directories if needed; like mkdir -p.
• cpr (⭐76) - cp -r for Node.js.
• cpy-cli (⭐279) - File/directory copying/renaming.
• copyfiles (⭐345) - Copy a list of files into a directory.
• sync-files (⭐42) - rsync-like directory syncing with watch mode.
• echo-cli (⭐6) - Cross-platform echo with JS escape sequence support.
• clear-cli (⭐46) - Clear the terminal.
• cross-env (⭐5.9k) - Set environment variables for scripts, unix-style.
• cross-os (⭐34) - Run platform-specific npm scripts.
• ntee (⭐23) - Utility that reads from standard input and writes to standard output and files; like Unix tee.
• catw - Print a file to stdout, with optional watch mode; sorta like Unix cat.

Utility Packs

• shx (⭐1.4k) - Collection of common Unix utilities implemented in Node.js; example usage: shx rm somefile.

Other Utilities

• hashmark (⭐194) - Take contents of a file and output as new file with a hash in the name.
• gzip-size-cli (⭐180) - Get the gzipped size of a file or stdin.
• opn-cli (⭐370) - Open websites, files, executables, etc. with the user's preferred application.
• headr (⭐3) - Add header / banner info to a file.
• Bower files CLI (⭐3) - Get main bower files on the command line.
• cli-error-notifier (⭐64) - Send native desktop notifications when npm scripts fail.

Miscellaneous

• screwy (⭐106) - The npm scripts GUI.
• Forrest (⭐338) - npm scripts desktop client.
• run-npm (⭐180) - Run locally-installed node module executables. Useful for debugging npm scripts.
• npm-quick-run (⭐131) - Quickly run npm scripts by prefix without typing the full name.
• edit-script (⭐9) - Edit npm scripts from the command line without worrying about JSON escaping.
• ntl (⭐872) - Interactive cli menu to list and run npm scripts.

Cross-platform Shell Reference

A quick reference of the shell operators & commands that work the same on Unix and Windows.

• Use && to run commands in sequence. If a command fails, the script exits.
• Use | to pipe the stdout of one command into the stdin of the next. (do-something | something else)
• Use > to write the stdout of a command to a file. (do-something > file)
• Use < to send the contents of a file to a command's stdin. (command < file)
• Use cd <dir> to change the current working directory to <dir>. Note that cd alone prints the current working directory on windows, but changes the working directory to ~ on *nix.

npm run Reference

You can use npm run-script or npm run; they both do the same thing, but npm run is shorter.

• Run just npm run to print a list of scripts.
• Running npm run script (where script is the name of your script) will run prescript, script, and postscript; in that order.
  • You can't nest pre and post hooks (i.e. preprescript won't work).
• You can pass arguments to your scripts by passing -- to npm run, followed by the arguments. Example: Given the script "mocha": "mocha", you can run npm run mocha -- --reporter xunit. This effectively runs mocha --reporter xunit.
• Running npm test is the same as running npm run test. The same applies to npm start and npm stop.
• You can run npm run <script> -s to silence the default npm output (useful for calling a script within another script).

Contributing

See CONTRIBUTING.md (⭐677).