Most GitHub profiles look like this:
# Hi, I'm John 👋
I'm a developer who likes coding.
And that's it. A plain heading, maybe a bullet list of tech, nothing else.
Your profile is the first thing a recruiter, collaborator, or fellow developer sees when they look you up. You've got about three seconds to make an impression. A wall of plain Markdown isn't making one.
Here's what the good profiles have in common: animated headers, auto-updating stats, and dynamic content that actually runs on GitHub's own infrastructure — all via GitHub Actions, no external servers required.
I put together a repo that walks you through exactly how to do this, step by step.
What You Can Build
Here's what a finished profile can include — all generated automatically:
- An animated gradient header banner (updates on every page load)
- A typing animation for your intro line
- Auto-updating stat cards: commits, stars, PRs, streak
- A language breakdown chart
- A tech stack badge grid
- A snake animation that eats your actual contribution graph
- Custom GitHub Actions that pull in blog posts, WakaTime stats, weather — anything with an API
No design skills required. Every piece is copy-paste ready.
The Tools
These are the services that power the best GitHub profiles. They're all free.
— same idea, but for typing animations. Pass your lines of text as URL params, get back an SVG that types them out in sequence.
— the more powerful alternative. Runs as a GitHub Action inside your profile repo, generates a full metrics image, and commits it back automatically. Supports dozens of plugins: calendar heatmap, achievements, languages over time, and more.
— clean, consistent badges for tech stack, social links, build status, anything.
How GitHub Actions Makes This Dynamic
Here's the part that makes this more interesting than a static README.
GitHub lets you create a repository with the same name as your username. Whatever README is in that repo gets displayed on your profile page. That's the trick everyone knows.
What fewer people do is run GitHub Actions inside that repo on a schedule.
A workflow like this runs every day at midnight:
name: Update Profile
on:
schedule:
- cron: '0 0 * * *'
workflow_dispatch:
jobs:
update:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Generate metrics
uses: lowlighter/metrics@latest
with:
token: ${{ secrets.METRICS_TOKEN }}
filename: metrics.svg
base: header, activity, community, repositories
- name: Commit changes
run: |
git config user.name "github-actions[bot]"
git config user.email "github-actions[bot]@users.noreply.github.com"
git add metrics.svg
git diff --cached --quiet || git commit -m "chore: update metrics"
git push
Your profile README then just references metrics.svg as a normal image. Every day it's fresh. No server. No hosting. GitHub does the compute for free.
Three Templates to Start From
Rather than building from scratch, the repo includes three starting points:
Minimal — capsule-render header, typing SVG intro, shields.io badges, one stats card. Clean and professional. Good if you want something polished without the maintenance overhead of Actions.
Developer — everything in Minimal plus a streak card, language breakdown, and activity section. More visual, still no Actions required.
Advanced — the full setup. GitHub Actions for auto-updating metrics, the snake animation workflow, and a custom Action that pulls in your latest blog posts. This is the one that makes people ask "how did you do that."
Quick Start
Three steps:
1. Create your profile repo. New repository, name it exactly the same as your GitHub username. Initialize with a README. GitHub recognizes this automatically and displays it on your profile.
2. Pick a template. Go to
If it's useful, a ⭐ on the repo helps other developers find it. There's also a . If you want to write a custom Action that fetches your latest blog posts, guide 08 covers that.
Happy building.
SOCIAL SHARE CARD GENERATOR