Skip to main content
Ben Nadel at Scotch On The Rock (SOTR) 2010 (London) with: Mark Drew and Reto Aeberli
Ben Nadel at Scotch On The Rock (SOTR) 2010 (London) with: Mark Drew ( @markdrew ) Reto Aeberli ( @aeberli )

Including node_modules And vendors Folders In Your GitHub Pages Site

By on

CAUTION: This post is mostly a note-to-self, for Future Ben.

Yesterday morning, I woke up, pushed a new demo to my JavaScript Demos project on GitHub, and then subsequently found out that every single one of my demos was broken. Apparently GitHub started using Jekyll 3.3.0 to power GitHub pages (which is how I render my demos on a gh-pages branch). This version of Jekyll ignores the "vendor" and "node_modules" directories by default, which is why all of my demos were broken. You can override this behavior, but doing so was not obvious to me.

First, I want to give a huge shout-out to Eric McCormick, Erik Zaadi, and Bill Rawlinson who watched me panic on Twitter and then helped me to regain my composure.

According to the GitHub blog post, you can add a _config.yml file to tell Jekyll to "include" the "node_modules" and "vendors" directories. I don't know anything about Jekyll (or even that this is what was powering GitHub Pages); so I tried creating a _config.yml file. To no avail. Nothing changed.

Apparently, according to the GitHub support ticket I opened, _config.yml only works if you're actually using Jekyll in your GitHub Pages branch:

Hey Ben,

Sorry for the confusion here.

We recently moved to Jekyll 3.3. which ignores the "vendors" folder by default.

A _config.yml file will only work if you are using Jekyll, so the .nojekyll is your best bet.

Since I'm not using Jekyll - since I thought GitHub pages was just "HTML" - I created an empty .nojekyll text file in the root of my gh-pages branch. And kablamo! It started working again!

Future Ben, you're welcome.

Reader Comments


Thank you thank you thank you! This is the only resource on this issue I could find. Adding the empty .nojekyll file worked!


Thank you very much. You are a savior. I was trying the service worker and faced the node_modules issue which consumed a lot of time. The .nojekyll worked and could find the solution only here. Thanks a lot again. Salute from India.

I believe in love. I believe in compassion. I believe in human rights. I believe that we can afford to give more of these gifts to the world around us because it costs us nothing to be decent and kind and understanding. And, I want you to know that when you land on this site, you are accepted for who you are, no matter how you identify, what truths you live, or whatever kind of goofy shit makes you feel alive! Rock on with your bad self!
Ben Nadel