Create your GitHub profile README

Let's start with the basics

Your username powers the live widgets. The header is the big line at the top; the headlines are the small lines beneath it.

GitHub username

github.com/

Powers your stats cards and dynamic widgets.

Header — the big line at the top

Type your name after it (“Hello! I’m Anurag”), replace it entirely, or clear it to hide the header.

Profile portrait — optional Hero visual

Upload a photo. Profile Studio converts it locally into a dot-matrix SVG; your original photo is not packaged.

Use photo colorsKeep the portrait in color. Reveal animationBuild the portrait from top to bottom. Profile viewsShow a public profile-view counter beneath your social badges.

Headline 1 — small line under your name

Headline 2 — optional, adds a second animated line

Headline color — for the moving lines (different from the header)

About you

A short intro, plus optional lines. Drag the ⋮⋮ handle to reorder how they appear.

Bio

Tech stack

Pick what you work with. Each selection becomes a colored badge in your README.

Connect

Add the links you want people to find. Enter just a handle — we'll build the full URL. Drag ⋮⋮ to reorder.

Dynamic add-ons

Live widgets that auto-update on your real profile. They render from your GitHub username.

Your README is ready

Grab the markdown, or start a fresh profile. Publishing it takes about 30 seconds.

Publish it to your profile

Create a new public repository named exactly the same as your GitHub username: your-github-username.
Add the README.md file you just downloaded to the root of the repository.
Commit the changes, then visit github.com/your-github-username. Your README will appear on your GitHub profile.

Example: If your GitHub username is your-github-username, your special repository must also be named your-github-username.