GitHub - arifszn/ezprofile: Kickstart your personal portfolio with Github Api an...
source link: https://github.com/arifszn/ezprofile
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
ezProfile
A modern, responsive and customizable portfolio builder for Developers!
https://arifszn.github.io/ezprofile
ezProfile is an easy-to-customize personal dev portfolio builder that is created with React.js. When you manage the code in a GitHub repository, it will automatically render a webpage with the owner's profile information, including a photo, bio, and repositories. Also, it includes space to highlight your details, job history, education history, skills, and recent blog posts.
It's all possible using GitHub API (for automatically populating your website with content) and Article-api (for fetching recent blog posts).
✓ 21 Themes
✓ Google Analytics
✓ Meta Tags
✓ Avatar and Bio
✓ Social Links
✓ Skills
✓ Experience
✓ Education
✓ Projects
✓ Blog Posts
To view a live example, click here.
Installation & Set Up
These instructions will get you a copy of the project up and running on your local machine.
You'll need Git and Node.js (which comes with npm) installed on your computer.
-
Fork the repo so you have your own project to customize. A "fork" is a copy of a repository.
-
Once you've found a home for your forked repository, clone it.
-
Change into your new directory.
cd ezprofile
- Install dependencies
npm install
- Start the development server
npm start
Customization
All the magic happens in the file src/config.js
. Open it and modify it according to your preference.
These are the default values:
config.js
Themes
There are 21 themes available that can be selected from the dropdown.
The default theme can be specified.
// config.js module.exports = { // ... themeConfig: { default: 'light', // ... } }
Here are some screenshots of different themes.
Google Analytics
ezFolio supports both GA3 and GA4. If you do not want to use Google Analytics, keep the id
empty.
// config.js module.exports = { // ... googleAnalytics: { id: '' }, }
Besides tracking visitors, ezFolio will track click events on projects and blog posts, and send them to Google Analytics.
Meta Tags
Meta tags will be auto-generated from configs dynamically. However, you can also manually add meta tags in public\index.html
Avatar and Bio
Your github avatar and bio will be displayed here.
Social Links
ezProfile supports linking your social media services you're using, including LinkedIn, Twitter, Facebook, Dribbble, Behance, Medium, dev.to, personal website, and email.
// config.js module.exports = { // ... social: { linkedin: 'ariful-alam', twitter: 'arif_swozon', facebook: '', dribbble: '', behance: '', medium: '', devto: '', website: 'https://arifszn.github.io', email: '' }, }
Skills
To showcase your skills provide them here.
// config.js module.exports = { // ... skills: [ 'JavaScript', 'React.js', ], }
Empty array will hide the skills section.
Experience
Provide your job history in experiences
.
// config.js module.exports = { // ... experiences: [ { company: 'Company name 1', position: 'Software Engineer', from: 'July 2019', to: 'Present' }, { company: 'Company name 2', position: 'Jr. Software Engineer', from: 'January 2019', to: ' June 2019' } ], }
Empty array will hide the experience section.
Education
Provide your education history in education
.
// config.js module.exports = { // ... education: [ { institution: 'Institution name 1', degree: 'Bachelor of Science', from: '2015', to: '2019' }, { institution: 'Institution name 2', degree: 'Higher Secondary Certificate (HSC)', from: '2012', to: '2014', } ], }
Empty array will hide the education section.
Projects
Your public repo from github will be displayed here automatically. You can limit how many projects do you want to be displayed. Also, you can hide forked or specific repo.
// config.js module.exports = { // ... github: { username: 'arifszn', sortBy: 'stars', limit: 8, exclude: { forks: false, projects: ['my-project1', 'my-project2'] } }, }
Blog Posts
If you have medium or dev.to account, you can show your recent blog posts in here just by providing your medium/dev.to username. You can limit how many posts to display (Max is 10
).
// config.js module.exports = { // ... blog: { source: 'dev.to', username: 'arifszn', limit: 5 }, }
The posts are fetched by Article-api.
Deploy
Once you are done with your setup and have completed all steps above, you need to put your website online! The fastest approach is to use GitHub Pages which is completely free.
1. Github Pages:
-
Rename your forked repository to
username.github.io
in github, whereusername
is your GitHub username (or organization name). -
Open
package.json
, and changehomepage
's value tohttps://username.github.io
.// package.json { // ... "homepage": "https://username.github.io", }
-
Run
npm run deploy
. -
If you see only
README
atusername.github.io
, be sure to change your GitHub Page's source togh-pages
branch. See how to.Your personal portfolio will be live at
username.github.io
. For more info, visit here.
2. Other: You can also host your website to Netlify, Vercel, Heroku, or other popular services. Please refer to this doc for a detailed deployment guide.
Please Read
I intend to keep my works open source. Please do not discourage me by claiming this work by copying it as your own or removing the footer notice.
Support
If you are using this project and happy with it or just want to encourage me to continue creating stuff, you can do it by just starring and sharing the project.
Contributing
Any contributors who want to make this project better can make contributions, which will be greatly appreciated. To contribute, clone this repo locally and commit your code to a new branch. Feel free to create an issue or make a pull request.
License
ezProfile is licensed under the Apache-2.0 License.
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK