A clean, beautiful, responsive and 100% customizable portfolio template for Software Developers!
⭐ Star us on GitHub — it helps!
✔️ Summary and About me
✔️ Skills
✔️ Open Source Projects Connected with Github
✔️ Experience
✔️ Certifications 🏆
✔️ Blogs
✔️ Education
✔️ Contact me
To view a live example, click here
- The website is completely built on
react-js
framework ofjavascript
and that's why we neednodejs
andnpm
installed. - While installing
nodejs
andnpm
, try to install versions which are equal or greater than the versions mentioned in badges above. - You can fork the repository just by clicking the button on the top-right corner of this page.
- After the successful installation of
nodejs
andnpm
, clone the repository into your local system using below command:-
git clone https://github.com/ashutosh1919/masterPortfolio.git
- This will clone the whole repository in your system.
-
- To download required dependencies to your system, navigate to the directory where the cloned repository resides and execute following command:
-
npm install
-
- Now, the project is ready to use.
- You can check it using
npm start
, it will open the website locally on your browser.
In this project, there are basically 3 things that you need to change to customize this to anyone else's portfolio: Personal Information, Github Information and Splash Logo.
You will find src/portfolio.js
file which contains the complete information about the user. The file looks something like below:
// Home Page
const greeting = {
...
}
// Social Media
const socialMediaLinks = {
...
}
...
You can change the personal information, experience, education, social media, certifications, blog information, contact information etc. in src/portfolio.js
to directly reflect them in portfolio website.
You will find git_data_fetcher.js
file in the main directory of the repository. This file is used to fetch the data (Pull requests, Issues, Organizations, Pinned projects etc.) from your github.
If you open the file, you will see below component at the top of the file. You need to change only that component.
const openSource = {
githubConvertedToken: "Your Github Token Here.",
githubUserName: "Your Github Username Here.",
};
You can get github token as described here. Give all permissions while generating token. Also add your github username. Now, you need to run following command.
node git_data_fetcher.js
This will fetch all the data from your github and it will automatically replace my data with yours. Whenever you want to update the github related information on the website you need to run this command.
Note here that if you click my portfolio, you can see animating the logo at the beginning. I have designed that logo in Figma
and then animated it using css.
Therefore, this part of portfolio is not customizable. But don't worry we have a solution to this problem. You have below two alternatives:
- If you want to design your own logo, then you can design it using
Figma
orAdobe XD
orAdobe Illustrator
orInkscape
. If you want to animate it, you can refer to./src/components/Loader
directory which containsjs
andcss
files which animates the logo. - If you don't want Splash screen or you don't know how to design logo, then this option is for you.
- You can open
src/portfolio.js
file and at the top of this file you will seesettings
component as below: -
// Website related settings const settings = { isSplash: true, };
- Change
isSplash
fromtrue
tofalse
. - Now, if you see your website using
npm start
, it will directly openhome
rather than animating logosplash
screen. - If you design your logo in future, then edit the files in
./src/components/Loader
and then revertisSplash
totrue
insrc/portfolio.js
.
- You can open
- You can take a look at
src/theme.js
file where all available themes are mentioned with respective color codes. - At the bottom of this file you will see the below code:
export const chosenTheme = blueTheme;
- You need to change the name from
blueTheme
to whatever theme you want to set your website to. - You can define new theme similarly as other themes and you can assign name of that new defined theme to
chosenTheme
.
- That's it. You just need to change the theme name and the code will take care of everything else.
- Once you have done with your setup and you have successfully completed all steps above, You need to put your website online!
- I highly recommend to use Github Pages to achieve this on the EASIEST WAY.
- To deploy your website, first you need to create github repository with name
<your-github-username>.github.io
. Please don't give any other name. - Push the generated code to the
master
branch of this repository. - Now, we need to generate production build and deploy website.
npm run build
command will generate the production build.npm run deploy
will create another branch calledgh-pages
and it will push thebuild
files to that branch.
- The last step in deploying is to enable
Github Pages
in settings of the repository and selectgh-pages
branch. - Now, your website is successfully deployed and you can visit it at
<your-github-username>.github.io
.
This project is licensed under the MIT License - see the LICENSE.md file for details.
If you can help us with these. Please don't hesitate to open an pull request or issue.
- Move to Gatsby
- Add Podcast Section and Video Section
- Add tests to automate review.
- Setup Travis workflow.
Ashutosh Hathidara 💻 📖 🎨 🚧 🤔 |
Some Design and Implementation Ideas are taken from Saad Pasta's Portfolio Project.