This is a sample repo using react, react-router, and gh-pages to run a react website with multiple pages through github.
Support for figuring out how to use react-router in 2020 came from this great article from Free Code Camp by Ibrahima Ndaw. It is definitely recommended to have an understanding of react before attempting this. You can either read React documentation. on the react website or follow this react lesson on FreeCodeCamp.org.
I used the blog post "Deploying a create-react-app with routing to GitHub pages which covered setting up npm gh-pages and having a parent class of HashHistory to keep your subfolders in place when react renders your pages. You can also use browserRouter which removes the # in the url. For BrowserRouter if you set your basename to "/" it will use the "{github_usernamme}.github.io/" url format, where the {github_username} implies your actual github username ie in my case "ifelawal.github.io". If you want your url to retain the "{github_usernamme}.github.io/{repo_name}" format you need to set your basename="/{repo_name}." It may have other benefits as well, especially since on the reacttraining page there is a note on HashRouter and it's lack of support on location.key, however I am not experienced enough to cover the differences.
This project was also bootstrapped with Create React App.
In the project directory, you can run:
Runs the app in the development mode.
Open http://localhost:3000 to view it in the browser.
The page will reload if you make edits.
You will also see any lint errors in the console.
Launches the test runner in the interactive watch mode.
See the section about running tests for more information.
Builds the app for production to the build folder.
It correctly bundles React in production mode and optimizes the build for the best performance.
The build is minified and the filenames include the hashes.
Your app is ready to be deployed!
See the section about deployment for more information.
You can learn more in the Create React App documentation.
To learn React, check out the React documentation.