Design-led GitHub profile README templates.
From minimal type studies to 3D contribution skylines — copy, paste, ship.

Browse the gallery →
filter by category, kind and level · live previews · copy the block in one click

---

Every other "awesome profile README" project does one of three things: links to other people's profiles for inspiration, generates generic markdown from a form, or piles up unstyled examples that all look the same. This one ships ready-to-paste, design-led templates — every one held to a senior frontend bar, and every claim on this page checked by CI rather than by hand.

Avant-Garde is the showcase tier — multi-layer feTurbulence and feDisplacementMap for living aurora flow, animated iridescent gradients for trading-card foil, path morphing through six geometric forms, network graphs with nine simultaneous signal pulses on real motion paths. Everything still pure SVG: no script, no GIF, no service.

Past it the kit widens rather than escalates. Print & Analog rebuilds halftone screens, misregistration, paper grain and drafting jitter out of <pattern> and filter primitives. Swiss & Brutalist is the counterweight to everything glowing: grid, weight, one accent. Generative draws your own numbers with an algorithm instead of a chart library — and holds itself to the numbers being true, which is why the language map is a solved power diagram rather than a Voronoi that quietly equalises every cell. Purpose-Built gives up on looking clever and tries to save somebody a message.

You shouldn't have to be a designer to look like one on GitHub.

1. Browse the categories below and pick a template that matches your tone.
2. Open the template's folder — every template has its own README with a copy-and-customize block.
3. Replace the {{placeholders}} (each template lists exactly which ones it uses) and paste into your <your-username>/<your-username> profile repo's README.md.

Templates are not all the same shape, and the gallery says which is which on every card. Check the kind before you pick:

Kind	What you get
svg	ships a self-hosted SVG you download and commit
markdown	pure markdown — no images at all
action	a GitHub Action generates it in your repo
technique	a pattern you apply inside another template

svg templates are the self-contained ones: you commit a single file to your own repo and nothing can rate-limit or 404 on you. action templates regenerate themselves on a schedule and need a one-time workflow — each carries the exact YAML in its README, and the same file is committed under workflows/ so you can download it instead of copying.

---

Less is more. Templates that earn attention through restraint.

Editorial Card markdown · Basic Magazine-style serif. No deps.

Monospace CV markdown · Basic Profile as a terminal session.

One focal motion done well — never a carnival.

Neon Pulse Banner svg · Intermediate Wide gradient hero with a slow wave.

Typewriter Intro svg · Basic A terminal that types itself in.

Depth, perspective, motion that hints at WebGL — running entirely on <svg>.

3D Contribution Tower action · Advanced Your contributions as an isometric skyline.

Tech Sphere svg · Advanced A rotating orbit of your stack.

Arcade-grade. Auto-updated by GitHub Actions.

Snake Eat Graph action · Intermediate The classic. Eats your contributions daily.

Pac-Man Graph action · Intermediate The louder cousin. Ghosts included.

Stats-heavy templates that read like product analytics pages.

Analytics Grid svg · Intermediate Metric cards with sparklines. Dashboard energy.

Activity Pulse action · Advanced One card. Lots of signal. metrics-engine.

Visual, brand-driven, opinionated. For people whose work is the way it looks.

Glassmorphism Hero svg · Advanced Frosted glass on a melting gradient.

Editorial Magazine markdown · Intermediate Typeset like a small print quarterly.

Strong aesthetic identity. Pick one and commit.

Cyberpunk Neon svg · Advanced Vaporwave grid + chromatic aberration.

Dark Elegant svg · Intermediate Monogram, gold hairline, restraint.

Techniques that make every other template better. Use them inside whichever you pick.

Light / Dark Switcher technique · Basic One picture tag, perfect theme parity.

Collapsible Projects markdown · Basic Pack ten projects into the space of three.

What the GitHub README format is actually capable of when you push every SVG primitive at once. No scripts, no GIFs, no external services — just SMIL animation, filter primitives, path morphing, and motion paths, composed with intent.

Aurora Veil svg · Advanced Multi-layer turbulence + displacement, never repeats.	Holographic Foil svg · Advanced Trading-card foil, animated stop-color iridescence.
Liquid Morph Wordmark svg · Advanced Path interpolation across six geometric forms.	Neural Pulse Lattice svg · Advanced 10 nodes, 15 edges, 9 signals — animateMotion + mpath.

Halftone screens, misregistration, paper grain, drafting jitter — the vocabulary of things that were printed, rebuilt with SVG filter primitives.

Risograph Poster svg · Advanced Two-ink riso print, halftone screens and all.	Blueprint Schematic svg · Advanced Your README, drafted as an exploded assembly.
Boarding Pass svg · Intermediate Where you are, where you are going, and a stub.	Vinyl Sleeve svg · Intermediate A record half out of its sleeve. Projects are the tracklist.

Grid, weight, and one accent. The counterweight to everything glowing.

Swiss Grid svg · Intermediate Twelve columns, left visible, and one red.	Brutalist Slab svg · Basic Heavy borders, deliberate overlap, one warning yellow.
Type Specimen svg · Basic Your name as a foundry specimen, ruled and measured.

Your own numbers, drawn by an algorithm rather than a chart library — and the numbers still have to be true.

Flow Field svg · Advanced A year of commits, drawn as a vector field.	Voronoi Territory svg · Advanced Your languages as territory, sized by how much you write them.
Strata Core svg · Intermediate Six years of commits as a drilled core sample.

Templates with a job to do. Less about looking good, more about saving somebody a message.

Open to Work svg · Basic Available, what you want, what you don't, and how to reach you.

OSS Maintainer svg · Basic What you maintain, how fast you answer, where to start.

---

#	Template	Category	Kind	Difficulty	External services
01	Editorial Card	Minimal	markdown	Basic	none
02	Monospace CV	Minimal	markdown	Basic	readme-typing-svg.demolab.com (optional)
03	Neon Pulse Banner	Animated	svg	Intermediate	none
04	Typewriter Intro	Animated	svg	Basic	none
05	3D Contribution Tower	3D & Immersive	action	Advanced	none
06	Tech Sphere	3D & Immersive	svg	Advanced	none
07	Snake Eat Graph	Gamified	action	Intermediate	raw.githubusercontent.com
08	Pac-Man Graph	Gamified	action	Intermediate	raw.githubusercontent.com
09	Analytics Grid	Dashboard	svg	Intermediate	github-readme-stats.vercel.app (optional)
10	Activity Pulse	Dashboard	action	Advanced	none
11	Glassmorphism Hero	Designer Portfolio	svg	Advanced	none
12	Editorial Magazine	Designer Portfolio	markdown	Intermediate	none
13	Cyberpunk Neon	Themed	svg	Advanced	none
14	Dark Elegant	Themed	svg	Intermediate	github-readme-stats.vercel.app (optional)
15	Light / Dark Switcher	Markdown Tricks	technique	Basic	github-readme-stats.vercel.app (optional) raw.githubusercontent.com (optional)
16	Collapsible Projects	Markdown Tricks	markdown	Basic	none
17	Aurora Veil	Avant-Garde	svg	Advanced	none
18	Holographic Foil	Avant-Garde	svg	Advanced	none
19	Liquid Morph Wordmark	Avant-Garde	svg	Advanced	none
20	Neural Pulse Lattice	Avant-Garde	svg	Advanced	none
21	Risograph Poster	Print & Analog	svg	Advanced	none
22	Blueprint Schematic	Print & Analog	svg	Advanced	none
23	Boarding Pass	Print & Analog	svg	Intermediate	none
24	Vinyl Sleeve	Print & Analog	svg	Intermediate	none
25	Swiss Grid	Swiss & Brutalist	svg	Intermediate	none
26	Brutalist Slab	Swiss & Brutalist	svg	Basic	none
27	Type Specimen	Swiss & Brutalist	svg	Basic	none
28	Flow Field	Generative & Data-Art	svg	Advanced	none
29	Voronoi Territory	Generative & Data-Art	svg	Advanced	none
30	Strata Core	Generative & Data-Art	svg	Intermediate	none
31	Open to Work	Purpose-Built	svg	Basic	none
32	OSS Maintainer	Purpose-Built	svg	Basic	none

---

	This repo	awesome-github-profile-readme	awesome-github-profile-readme-templates	Profilinator / GPRM
Ready-to-paste markdown	✅	❌	✅	✅
Design-led, opinionated templates	✅	❌	⚠️	❌
Boundary-pushing SVG (turbulence, path morph, animateMotion)	✅	❌	❌	❌
3D / immersive templates	✅	⚠️	❌	❌
GitHub Action setup walkthroughs	✅	❌	❌	❌
Dependency count stated per template	✅	❌	❌	❌
Quality bar enforced by CI, not honour system	✅	❌	❌	n/a
Browsable gallery with copy-to-clipboard	✅	❌	❌	⚠️

✅ yes · ⚠️ partial · ❌ no

---

Adding a new template? Read CONTRIBUTING.md — it documents the quality bar, the meta.json contract, and the PR process. The bar is not a checklist someone eyeballs: npm run check enforces it, and CI runs it on every pull request.

If you found a bug (broken link, wrong placeholder, render glitch on mobile), open an issue or PR with a screenshot.

This repo stands on the shoulders of the public services that make GitHub READMEs expressive. The list below is generated from what the templates actually depend on, so it can't drift into thanking something nothing uses:

• abozanona — pacman-contribution-graph
• anuraghazra — github-readme-stats
• crazy-max — ghaction-github-pages
• DenverCoder1 — readme-typing-svg
• lowlighter — metrics
• Platane — snk
• yoshi389111 — github-profile-3d-contrib

If your project is referenced and you'd like a different attribution wording, open an issue.

MIT — use these templates anywhere, no attribution required (but appreciated).