After facing numerous challenges with GitHub Pages' system, I must admit that finding an effortless solution for one of my biggest issues has been a struggle. GitHub Pages imposes a set of specific restrictions:
- Your resume repository must follow the format
{username}.github.io
. - The website must be located in the
master
branch.
While these limitations may seem straightforward, they are actually more complicated than they appear. Unlike user pages, which have their own dedicated repository, GitHub typically manages project websites using secondary branches. This is why many of the tools and modules available in the developer community focus on pushing the build to a secondary branch called gh-pages
.
Unfortunately, here's the bad news: The simplest way to host your ReactJS resume on GitHub Pages requires you to push the build folder after running the npm run build
command (on Windows), create another branch, and then push your original site code.
It may sound like extra work, but once you get the hang of it, hosting your React-based resume on GitHub Pages can be a smooth process.
Top comments (0)