DEV Community

Cover image for Creating amazing GitHub profiles README
Diona Rodrigues
Diona Rodrigues

Posted on • Edited on

Creating amazing GitHub profiles README

In the past few days, Github implemented a way to personalize our profile pages: Profile README. And it's amazing since we can now add a full description of ourselves and also mention which projects and studies we are focusing on, for example.

In this article, I'll highlight some creative examples and show you how you can create your own Profile README. 😎


About READMEs

README files typically include information about the project and each repository should have one. What the project does, how users can use the project and how to contribute to the project are some good content from READMEs.

But this new GitHub feature called Profile README can be used to inform people of more information about ourselves. It also supports markdown, which means that we can play a lot with HTML, gif, emoji... Read this GitHub article and Master Markdown.

Feel free to check out my GitHub profile. And below you can see a list of awesome repositories of examples of READMEs:


How to create your own Github Profile README

You can do this through the following steps:

1- Create a new repository with the same name as your GitHub account (in my case that´s github.com/dionarodrigues/dionarodrigues).

GitHub New Repository Page

This repository needs to be public and initialized with a README.

2- Edit README.md file with a customized content about you.

GitHub README editing page

3- Go to you profile page to see the changes.

Diona Rodrigues Github Profile Page

You can now see a new section at the top of the page that was automatically rendered from the new Profile README file.


How to improve your GitHub Profile READMEs content

Alt Text

You can also learn how to build a self-updating profile ✨.

Learn how to add shields into the content.

Learn how to add GitHub Readme Stats on your readmes!

See how to add Emoticon.


Creative examples of GitHub Profile READMEs

github.com/Thaiane
GitHub Profile Screenshot of Thaiane

github.com/ashbakernz
GitHub Profile Screenshot of Ash Baker

github.com/jlengstorf
GitHub Profile Screenshot of Jason Lengstorf

github.com/saadeghi
GitHub Profile Screenshot of Pouya Saadeghi

github.com/VedantKhairnar
GitHub Profile Screenshot of Vedant Khairnar

github.com/stephenajulu
GitHub Profile Screenshot of Stephen Ajulu

github.com/abhisheknaiidu
GitHub Profile Screenshot of Abhishek Naidu


I'm very excited about this GitHub release. How about you? Have you already changed your profile page?

Top comments (5)

Collapse
 
puneetgopinath profile image
Puneet Gopinath

If you want to add your recent activity on your profile readme.
You can't keep updating your recent activity on github daily.
Instead consider this github action if you want to show your recent activity in your profile readme!!

GitHub logo Readme-Workflows / recent-activity

Add your recent activity to your profile readme!

Recent Activity

starsBadge forksBadge issuesBadge sizeBadge codelinesBadge codeOfConductBadge

uniqueUsersBadge totalrunsbadge successratebadge

discordBadge

This GitHub Action is a Fork of the original GitHub Activity Readme Action by jamesgeorge007.
Its our goal is to improve the original GitHub Action while also providing new features for the users.

Live Preview

This is an example live preview that is updated every time a commit is pushed using github actions.

Features

Support for many events

Events we support:

  • CommitCommentEvent - commenting on a commit
  • CreateEvent - A new repo was created
  • ForkEvent - You forked a repo
  • GollumEvent - Wiki was updated in a repo
  • IssueCommentEvent - You commented on a issue
  • IssuesEvent - You opened a issue
  • MemberEvent - You joined a org/repo as a member
  • PullRequestEvent - You opened a pr.
  • PullRequestReviewCommentEvent - You commented on a pr review
  • PullRequestReviewEvent - You reviewed a pr
  • ReleaseEvent - You released a new version
  • WatchEvent - You watched a repo.

Customizable Settings

Adjust the…

If you find the github action useful, show some love by giving a ⭐ on the github repo

Collapse
 
shravan20 profile image
Shravan Kumar B

Hi, please do check this project, maybe you can use this to beautify your Profile Readme.

GitHub Dynamic Animated Quote Generator

Collapse
 
putroandrianto profile image
Andrianto Cahyono Putro

thanks

Collapse
 
tadjerounimohamedadel profile image
Adel Mohamed Tadjerouni

Thanks for the post and the examples, it was very helpful and inspiring

Collapse
 
danbmky profile image
Dan Bamikiya

Hi I've changed my Github profile page. Check it out: github.com/danBamikiya