NPM-STOP(1)

💅 NPM-STOP(1) 💅

ok so bestie, you're looking at npm-stop — the manual page for npm-stop — and honestly? it's giving "small but mighty" energy. it stops a package, that's the whole vibe. let's get into it 🎀

---

✨ NAME ✨

npm-stop — stop a package 🛑

---

🌸 Synopsis 🌸

npm stop [-- <args>]

literally that's it. look at her go 💅

---

🦋 Description 🦋

okay so what this actually does is run a predefined command — the one you wrote in the "stop" property of your package's "scripts" object. that's the whole thing. you defined it, npm runs it. iconic behavior.

⚠️ important heads-up bestie: unlike npm help start, there is no default script that will run if the "stop" property isn't defined. so if you didn't write one... nothing happens. no fallback, no safety net, no plan B. it's just silence 😭 fr fr check your package.json first.

---

🎀 Example 🎀

here's what it looks like in the wild, no cap:

{
  "scripts": {
    "stop": "node bar.js"
  }
}

then you hit:

npm stop

and you get:

> npm@x.x.x stop
> node bar.js

(bar.js output would be here)

see how it echoes the script and then runs it? that's the moment. main character energy 🔥

---

👑 Configuration 👑

🌈 ignore-scripts

• Default: false
• Type: Boolean

if this is true, npm does not run scripts specified in package.json files. periodt.

💀 but here's the nuance (iykyk): commands that are explicitly intended to run a particular script — like npm start, npm stop, npm restart, npm test, and npm run — will still run their intended script if ignore-scripts is set. what they won't do is run any pre- or post-scripts. so the main script slays, the openers and the encores get benched 🫶

also also also: setting ignore-scripts also disables .npm-extension execution, as if ignore-extension were set. two-for-one deal, not the fun kind 🙈

🧚 script-shell

• Default: '/bin/sh' on POSIX systems, 'cmd.exe' on Windows
• Type: null or String

this is the shell used for scripts run with the npm exec, npm run and npm init <package-spec> commands. pick your fighter ⭐

---

⭐ See Also ⭐

• npm help run
• npm help scripts
• npm help test
• npm help start
• npm help restart

---

ok that's the whole page bestie, you're officially educated 💜 now go forth and stop some packages responsibly. mwah 🫶✨

signing off — this was npm-stop, straight outta NPM@12.2.1, dated October 2026 (yes, the October 2026 girlies, we exist), manual section NPM-STOP(1) 🎀 bye bye!!