DEV Community

Cover image for GitHub Profile as a Portfolio: Your thoughts?

Posted on

GitHub Profile as a Portfolio: Your thoughts?

Thanks to GitHub profile readmes, the user can include all the bio and links in the profile, bringing the functionality closer to the full portfolio.

That brings up the discussion do you still need both as the info included in both might duplicate a lot. What are your thoughts on this?

Top comments (17)

michaelgee profile image
Michael Gee

I personally disagree with having a Github profile as your portfolio, it should be more of an introduction.

Your personal website/portfolio is a great opportunity to showcase your coding and design skills in practice. As a web developer, it just makes more sense to display your projects and info in code rather than markdown.

This can obviously be a bit tricky for back-end developers but I'd say with much simpler UI they can place more emphasis on their projects rather than design.

jacobmgevans profile image
Jacob Evans

Your projects are a great way to showcase your closing and design skills... Which are on GH. You can be pretty creative with the HTML and MD in GH special repo.

I'm a strong proponent for there is no one right way to be creative or present yourself.

joelbonetr profile image
JoelBonetR πŸ₯‡

totally agree

louislow profile image
Louis Low

I believe it could be somehow replacing the full portfolio for certain people who just want a landing page look like fit in their Github profile page. If design it carefully and properly. But not using the crappy and ugly generators. One day, I will make an example by using my UI design skill.

madza profile image

Looking forward to see it πŸ‘€πŸ˜‰

louislow profile image
Louis Low

You have my words, bro.

harshhhdev profile image
Harsh Singh

I'm not too sure oh having your entire profile readme as your portfolio. It can be a great introduction, yeah! The main purpose of these readmes, in my opinion, should be to give a brief overview of who you are, what you like, and what you have been working with/on for the past week, etc.

I don't know how impressed people would be if they see your portfolio is literally a brief one page summary of yourself...on GitHub.

Don't get me wrong, profile readmes are great. I personally love them, though a person would (probably) be more impressed if he/she saw a more interactive, colorful and beautifully designed webage (like this one), rather than a 1 page brief introduction to your skills and projects. Especially if you're a web developer.

gsarig profile image
Giorgos Sarigiannidis

Given that both GitHub and LinkedIn are Microsoft properties, I believe that there is space for interesting integrations here.

nektro profile image
Meghan (she/her)

I recently switched to because I accepted that I never get around to it with all the time I spend working on my other projects. And with the ability to pin repo's to my profile, it shows all the info I want anyway.

delta456 profile image
Swastik Baranwal

I have used it as a general introduction not portfolio. I think portfolio deserves a better space.

dar5hak profile image
Darshak Parikh

Agreed. Portfolio is something that requires more screen estate. I also prefer applying a personal style to a portfolio as opposed to plain Markdown.

dwjohnston profile image
David Johnston

It depends on what you mean by 'portfolio'.

Plenty of social media accounts have a single 'website' option, and yeah - unless you have your own website, then I think github is what I would be putting in.

That said, making your own website can be good too, though, a bit of work and maybe you have better things to do, maybe you aren't a web developer.

rahuldkjain profile image
Rahul Jain

I personally feel that the use case of GitHub Profile is different from Personal Portfolio.

GitHub profile is really helpful to give a brief introduction about yourself as a developer/engineer, whereas a personal portfolio is meant to showcase the projects and experience in a more detailed way.

If you want to develop both, I've developed tools that will make your journey easier.

  • GitHub Profile README Generator πŸš€ Try the tool: live tool

If you find the tool useful, show some love by giving a ⭐ on ⭐️ repo

GitHub logo rahuldkjain / github-profile-readme-generator

πŸš€ Generate github profile README easily with latest add-ons like visitors count, github stats, etc using minimal UI.

GitHub Profile Readme Generator

GitHub Profile README Generator

github-profile-readme-generator licence github-profile-readme-generator forks github-profile-readme-generator stars github-profile-readme-generator issues github-profile-readme-generator pull-requests join discord community of github profile readme generator

github-profile-readme-generator gif

View Demo Β· Report Bug Β· Request Feature

Loved the tool? Please consider donating πŸ’Έ to help it improve!

sponsor github profile readme generator Buy Coffee for rahuldkjain Buy Me A Coffee

Tired of editing GitHub Profile README with new features? This tool provides an easy way to create a GitHub profile readme with the latest add-ons such as visitors count, github stats, etc. πŸš€ Demo

Try the tool: GitHub Profile README Generator

🧐 Features

Just fill in the details such as Name, Tagline, Dev Platforms Username, Current Work, Portfolio, Blog, etc. with a minimal UI.

  • Uniform Dev Icons

  • Uniform Social Icons

  • Visitors Counter Badge

  • GitHub Profile Stats Card

  • GitHub Top Skills

  • Dynamic Dev(.)to Blogs (GitHub Action)

  • Dynamic Medium Blogs (GitHub Action)

  • Dynamic Personal Blogs from RSS Feed (GitHub Action)

  • Wakatime Stats contribute

  • YouTube Stats contribute

Click on Generate README to get your README in markdown You can preview the…

Join Discord Server for discussions related to the project and Hacktoberfest.
Server Link:

  • Minimal Portfolio πŸ’ͺ A clean, minimal, responsive, and customizable portfolio template to showcase skills, experience, achievements, and favorites (movies & TVs).

GitHub logo rahuldkjain / minimal-portfolio

πŸ’ͺ A clean, minimal, responsive, and customizable portfolio template to showcase skills, experience, achievements, and favorites (movies & TVs).

Personal Porfolio for developers

πŸ’ͺ Awesome Personal Portfolio

The minimal, responsive and easily customisable portfolio for developers.

portfolio for software developer portfolio for software developer portfolio for software developer portfolio for software developer

portfolio for developers

⚑ Pages

🎯 Home (Introduction, Skills, Contact me)

🎯 Work (Internships, Projects, Miscellaneous Projects)

🎯 Achievements And Certifications

🎯 Favourites (Movies, TV/ Web Shows)

πŸš€ Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

You'll need Git and Node.js (which comes with npm) installed on your computer.

node@v10.16.0 or higher
npm@6.9.0 or higher
git@2.17.1 or higher

πŸ”§ How To Use

From your command line, clone and run minimal-portfolio:

# Clone this repository
$ git clone
# Go into the repository
$ cd minimal-portfolio
# Install dependencies
$ npm install
# Run 
$ npm run dev

πŸ› οΈ Customize

If you like the portfolio and want to use it to create your own, please refer customization manual.

πŸ§‘β€πŸ’» Technologies used

Demo: minimal-portfolio-rahuldkjain.netl...

madza profile image

Thanks for the insight πŸ”₯πŸ”₯

jacobmgevans profile image
Jacob Evans

Oh, I should include my ecosystem... My terminal and VSCode are HEAVILY modified πŸ˜…πŸ˜‚

malhotramanik profile image
Manik Malhotra

If you are a developer, bingo, you must have one.