What if I need to make a change in node_modules?

I have an application build on top of node/electron, and recently, because of an update in the electron, some dependencies have broken down, preventing me to upgrade to the newer versions while keeping all functionalities.

In such cases, the correct behavior would be to reach out to the dependency, and open an issue, or even submit a Pull Request, but what if your dependency is not maintained anymore, or the development process on such repository is stalled or slow, and you really need to move on with your development?

That was the scenario I was facing. The change I needed was very localized, but I could not, in a million tries, get to make it work on my fork of the dependency. To make things worst, the last commit on the repository was over 6 months ago, and no sign of a reply on the issue I opened in a week.

That's when I found patch-package, a package that lets app authors instantly make and keep fixes to npm dependencies.

# fix a bug in one of your dependencies
vim node_modules/some-package/brokenFile.js
# run patch-package to create a .patch file
npx patch-package some-package

# commit the patch file to share the fix with your team
git add patches/some-package+3.14.15.patch
git commit -m "fix brokenFile.js in some-package"

 "scripts": {
+  "postinstall": "patch-package"
 }

npm i patch-package

The README has all the information you'll need, but I'll summarize here the idea:

1. Install patch-package (using npm or yarn)

2. Update the scripts rule on your package.json to include a call for patch-package:
   

    "scripts": {
   +  "postinstall": "patch-package"
    }
   

3. Do the change you need on the dependency, directly on node_modules

4. Call patch-package specifying the package you modified:
   

   (npx | yarn) patch-package package-name
   

   The last command will create a patch file (a diff) in patches/, which is a diff between the public dependency and your changed version.

5. Commit the changes, including the new patch file and everything will be working as expected.

Now, whenever you (or someone) calls install on your repository, patch-package will be called, applying that change on it.

Problem solved!

What about you? Have you ever needed to take a similar action?