mldangelo.com and https://mldangelo.github.io/personal-site/

My personal website. Easily modifiable, and built using modern javascript with Node.js, React, Express, React-Router, Hot Module Reloading, Webpack and many other technologies.

A note on adapting this repository to your own personal website

Many people have contacted me about adapting this website. I have tried to make things as simple as possible. There are still bugs. I am sorry. If you find a bug, please email me (help@mldangelo.com) or submit a pull request to this repository.

Dependencies:

Tested with:

• node >= v8, v9, v10, v11
• Recommend nvm) for managing node versions
• Recommend yarn >= 1.0.0

Set up:

You may wish to fork this repository or remove my remote origin and add your own. Go here for more information on changing remotes.

1. To download the repository and install dependencies, run the following commands:

git clone git://github.com/mldangelo/personal-site.git
cd personal-site
yarn

If you do not have yarn installed, you may run npm install instead.

2. Next, you should create a .env file. To do this, run:

cp sample.env .env

and set values as appropriate. Most people will not need to make changes.

3. Run the following command to build the react application and serve it with hot module reloading:

npm run dev

Navigate to <ip>:<port> default: http://localhost:7999 to view my website.

This completes set up instructions. Please continue reading to learn how to modify this site to make it your own.

Checklist

1. Start by changing text in the sidebar. This file is located at app/components/Template/Nav.js.
2. Add an image of yourself in public/images/me_icon.jpg. If you decide to change the filename, be sure to go back to the sidebar and change the image path there as well.
3. Modify the text in app/views/Index.js
4. Modify the files in app/data/resume/ next. When you're finished, go back and modify all of the other files in the app/data/ directory.
5. You've finished modifying >95% of the pages. Search through the rest of the files for references to Michael or Angelo and change values to your name.
6. Change the description in server/views/404.html and server/views/index.tpl.html. You may also wish to add a new favicon or remove it. This website may be helpful.
7. Decide how and where you are going to host this project. I recommend purchasing your own domain name from Google Domains. If you would like to host on github pages, go to https://github.com/[your github username]/personal-site/settings and configure accordingly:

8. Configure your domains DNS record. See here for more information.
9. Modify the CNAME file to point to your URL. Note: if you do not plan on using a custom domain, you should remove this file and modify the npm deploy script by removing && cp CNAME dist/ from the predeploy line in the scripts section of package.json. If you plan to deploy to a /[path] (e.g. http://mldangelo.github.io/personal-site/), you should modify BASE_PATH in your .env and sample.env files and restart the express server. Note that you will now have to navigate to localhost:[port]/[BASE_PATH] when developing.

Deploying to Github Pages:

1. Change NODE_ENV to production in .env
2. Run npm run deploy

That's it.

Please feel free to reach out to me by filing an issue or at help@mldangelo.com for help configuring your project.

Contributors

• @mldangelo
• @typpo

Acknowlegements

• Special thanks to @typpo for tirelessly answering all of my node.js and react questions.
• Template based on Future Imperfect by @ajlkn for HTML5 UP.

License

MIT