Including node_modules And vendors Folders In Your GitHub Pages Site

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.

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!

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 am the co-founder and lead engineer at InVision App, Inc — the world's leading prototyping,
collaboration & workflow platform. I also rock out in JavaScript and ColdFusion 24x7 and I dream about
promise resolving asynchronously.