GitHub Profile README

Your GitHub profile README is your developer portfolio's front door. Make it count in the first 5 lines.

Recruiters spend ~10 seconds on your profile. Pin 3-4 best repos below the README and keep the intro scannable — walls of text get skipped.

GITHUB PROFILE README

Template

Tone

Main copy

Use markdown headers and bullet points — GitHub renders them natively. The first 3 lines appear above the fold on your profile. Lead with what you build, not a life story.

Additional details

Keep your stack list to 5-8 technologies max. Listing everything dilutes your signal.

Live preview

### Hey, I'm [Your Name]

[One-line intro: what you do + what excites you about it]

- Building: [Current project with link]
- Learning: [Technology you're exploring]
- Open to: [Collaboration type, e.g. OSS, speaking, freelance]
- Ask me about: [Your areas of expertise]

**Stack:** [Languages / Frameworks / Tools]
**Portfolio:** [Link]

Tips to strengthen your text

4/4

✓Opens with name and what you do

✓Includes what you're currently building

✓Lists your tech stack

✓Has a collaboration or contact prompt

Back to all tools

Browse all 25 tools