const alex = {
role: "Software Engineer",
location: "Remote",
currentFocus: "a realtime collaboration app",
learning: "Rust and WebAssembly",
askMeAbout: "React, Node.js, system design",
stack: ["JavaScript", "TypeScript", "Python", "React", "Node.js", "MongoDB"],
};
🛠️ Tech Stack
Languages
Frontend
Backend
Databases
Cloud & DevOps
Tools
📊 GitHub Stats
🌐 Connect with me
Everything a profile README needs
Turn sections on and off, reorder them, and see every change instantly, in light and dark mode, on desktop and mobile.
A header that introduces you
An animated banner with your name and role, a typing headline in your accent colour, and a short intro written as a list or as code.
Your tech stack, with official logos
Pick from 76 languages, frameworks and tools. Show them as badges, as an icon strip, or grouped into a table by category.
Stats that update themselves
A stats card, top languages, contribution streak, trophies, a contribution graph and a neofetch-style terminal card, all generated live from your GitHub activity.
The projects you're proud of
Pin cards for your best repositories, with descriptions, languages and stars pulled straight from GitHub.
Ways to reach you
LinkedIn, X, email, your blog and a dozen more, as matching badges, plus optional Ko-fi or Buy Me a Coffee links.
How to create a GitHub profile README
1
Import your GitHub profile
Enter your GitHub username. MakeReadme pulls in your name, bio, location, company, social links, top languages and most-starred repositories.
2
Customize every section
Pick a preset (such as Aurora, Minimal, Terminal or Mocha), choose your tech stack from 75+ logos, add stats cards, pinned projects and an animated banner in your accent color.
3
Download README.md
Copy or download the generated README.md, create a public repository named exactly like your username, and add the file. It appears at the top of your GitHub profile.
A GitHub profile README is a README.md file in a public repository whose name matches your GitHub username (for example octocat/octocat). GitHub shows it at the top of your profile page at github.com/<username>.
Is MakeReadme free?
Yes. MakeReadme is free, needs no account and no sign-up. Your draft is saved only in your browser's local storage.
How do I add the generated README to my GitHub profile?
Create a new public repository named exactly like your GitHub username, add the downloaded README.md to its root and commit. GitHub then displays it on your profile.
What can I put in my profile README with MakeReadme?
Animated capsule-render banners and footer waves, a typing-text headline, an About section written as a list, TypeScript object or Python class, social links, 75+ tech stack badges, GitHub stats, top languages, streak, trophies, contribution graph, a profile view counter, pinned repository cards, and Buy Me a Coffee or Ko-fi links.
Do the GitHub stats update automatically?
Yes. Stats, streak, trophies and contribution graphs are live images: MakeReadme serves its own stats, top-languages, terminal and repository cards, and streaks and trophies come from community services, so they refresh from your GitHub activity without editing the README again.
Does MakeReadme need access to my GitHub account?
No. It reads only public profile data through the GitHub API using your username. It never asks for a login, a token or write access.
Your profile, but way better.
A couple of minutes, no account, and your draft stays in your browser.
