Skip to content
Lesson 7 of 1258% of the course

Show your projects, stack and links on your GitHub profile

Add featured repositories, a tech stack in icons, what you are open to, social links and your latest posts to your GitHub profile README with Profile README Studio.

Video coming soonShow your projects, stack and links on your GitHub profileUntil then, the lesson below walks through every step.

Numbers say how much you do. Projects say what you do, and that is what people remember. This lesson adds the blocks that show your work and how to reach you, so a visitor leaves knowing what you build and where to find you.

Feature your best repositories

Add Featured repos from the Projects group. List the repositories you want people to see first; each becomes a pin card with its description, language and stars. Show the owner name on cards adds the owner to each card, useful when you feature repositories from an organization too.

One repository per line; each becomes a pin card.

Pick two to six, and pick by quality, not by stars. A small project with a clear README says more than a fork with a hundred stars.

Show your tech stack in one row

Add Tech stack icons from the Skills group. It draws rows of technology icons, each on a small tile in your theme's light or dark look. You can:

  • Group them with labels, like Languages, Frameworks and Tools
  • Set how many icons go on a line
  • Put the labels above each line or beside it

One row of icons reads faster than a wall of coloured badges, one per technology. The Profile Doctor even deducts points for a badge wall and offers to turn it into icons.

Say what you are open to

Open to (in the Contact group) shows small badges for what you are open to: a new job, freelance work, mentoring, collaboration, speaking, or your own text. For a job search, this one block does more than any stats card.

Social links lists where people can find you: GitHub, LinkedIn, X, a website, email and more. Style draws them as plain links, badges or icons. Contact adds a short contact section.

Plain links, badges or icons, in the order you list them.

Keep it to the two or three places you actually answer. An email or LinkedIn link that works beats ten icons.

Show your latest posts and activity

Two blocks update themselves with a GitHub Action in your profile repository:

BlockWhat it showsSetting
Latest blog postsYour newest postsThe feed address of your blog, like https://dev.to/feed/you, and how many
Recent activityYour latest pushes, pull requests and issuesHow many

In the README they start as a placeholder. When you export, the studio adds the profile workflow, which fills the placeholder on a schedule. The lesson on GitHub Actions explains how to add it.

Add personality, carefully

The Extras group has Quote, Visitor counter, WakaTime stats, Spotify now playing and your own Badges. The Layout group adds a Collapsible section, a Diagram (Mermaid) and a Terminal session.

The visitor counter and Spotify are the only blocks drawn by another service (komarev.com and spotify-github-profile.kittinanx.com). They work on your profile, where GitHub loads them through its own image proxy; in the studio you see an example.

One of these makes a profile yours. Five make it busy. Pick the one that says something about you.

Order the page for a stranger

A reliable order, top to bottom:

  1. Who you are, in one line (header or banner)
  2. What you do and what you are open to
  3. Your best projects
  4. Your stack
  5. Stats, if you want them
  6. How to reach you

The next lesson is about the day a card stops loading: finding broken widgets and making them unbreakable.

Your progress stays in this browser only.
Contact