Free Tool
A GitHub profile README generator is a free tool that builds the Markdown for your special username/username repository - adding stats cards, skill icons, and badges so your profile looks polished without writing Markdown by hand.
Fill in a few fields, watch the live preview update, copy the Markdown - that's it. No signup, no API calls.
Everything runs in your browser - nothing is sent to a server. Only your name is required; everything else is optional.
Tech stack
Social links
Sections to include
Applies to GitHub stats, top languages, streak, and trophy cards.
Markdown
Live preview
Building developer tools that make AI coding workflows feel native. Currently exploring agent loops, tool-use design, and streaming UIs.
Fun fact: I've shipped a side project every Sunday for 3 years.
Thanks for stopping by - I've shipped a side project every Sunday for 3 years.
Code Card turns your dev profile into a shareable, interactive card - contribution heatmaps for your AI coding sessions, model and tool breakdowns, badges, and a public URL you can drop straight into your README. Set up in 30 seconds with npx code-card.
Add your name, role, location, what you're working on, and a fun fact. Only the name is required - everything else is optional.
Select from common languages and frameworks, or type your own. Selected items render as a row of skill icons via skillicons.dev.
Choose which GitHub cards to embed - stats, top languages, streak, trophies, visitor counter - and pick a theme that matches your profile vibe.
Use the Copy Markdown button (or download README.md). The live preview on the right shows exactly how the file will render on GitHub.
Create (or open) the public repo named exactly your GitHub username, paste the Markdown into README.md, commit, and visit your profile page.
A GitHub profile README is a special README.md that GitHub displays at the top of your profile page. It lives in a public repository named exactly the same as your GitHub username (for example, alex/alex). You can use it to introduce yourself, list your tech stack, and embed live stats cards.
Create a new public repository with the exact same name as your GitHub username, add a README.md file to it, and GitHub will automatically display it on your profile. Paste the Markdown from this generator into that README.md, commit, and refresh your profile to see it.
Yes. The stats, top languages, streak, and trophy cards are SVG endpoints from open-source services (github-readme-stats, demolab streak stats, github-profile-trophy). They update automatically as your GitHub activity changes - you don't need to regenerate the README.
Yes - the generator is 100% free, runs entirely in your browser, and never sends your inputs to a server. No signup, no email required. It is built and maintained by Code Card as one of several free tools for developers.
No. GitHub's profile README feature is only available for user accounts, not organizations. The trick of creating a repo that matches your account name doesn't apply to org accounts. For org READMEs, use the .github repository's profile/README.md file instead.
