Full-Stack Dev
Building web apps end-to-end with TypeScript, React, and Node.js.
Free · Client-Side · No Account
Generate your GitHub profile
README in seconds
Fill the form. Copy the markdown. Paste into GitHub.
Your data never leaves your browser — zero servers, zero tracking.
The Generator
Build your README
Fill in the fields below — your markdown updates in real time on the right.
Your details
README.md — preview
Fill out the form to see a live preview here.
Generated markdown
# Fill out the form to generate your READMEOne-click Presets
Start from a persona
Not sure where to start? Pick the preset that's closest to you — then customize.
OSS Maintainer
Maintaining open-source libraries used by thousands of developers.
Design Engineer
Bridging design and code — component systems, Figma to production.
Indie Maker
Shipping small SaaS products, tools, and experiments solo.
Why this generator
No ads. No account. No server.
100% client-side
All markdown assembly runs in your browser. Your inputs never touch a server — not ours, not anyone's. Open DevTools → Network to verify.
No account required
Open the page and start typing. No sign-up, no email, no OAuth. Works in any modern browser — even offline after first load.
MIT licensed — self-host it
Download the source, fork it, deploy it on your own domain. No dependency on our uptime. Customize the tech chips, add your own persona presets.
The craft
What goes in a great README
Based on the awesome-github-profile-readme gallery — top-performing profiles share 5 elements in common.
- 1
Concise greeting header
Name + role, centered. One line, not an essay. First impression matters — visitors scan in under 3 seconds.
- 2
3–5 bullet "about" points
What you're working on, what you're learning, a fun fact. Not a paragraph of prose — bullets are scannable. Five max.
- 3
Tech stack badges
shields.io flat-style badges, grouped by category. 8–15 is the sweet spot — enough to signal your depth, not so many you look like you're padding.
- 4
Stats + streak cards
github-readme-stats and streak-stats are the two canonical widgets. They update live. Pick a theme that matches your vibe — don't mix light stats with a dark README.
- 5
Social links as icon badges
LinkedIn, Twitter/X, portfolio, Dev.to — linked shields.io badges keep the visual language consistent. No plain text URLs.
FAQ
Common questions
- No. All markdown assembly is pure JavaScript string interpolation that runs entirely in your browser. No network requests are made with your data — not to our servers, not to any third party. You can verify this by opening DevTools → Network while filling the form.
- Yes — it's plain markdown. Copy it, paste it into any text editor (VS Code, Typora, even GitHub's web editor), and change whatever you like. Add sections, remove sections, tweak wording. The generated output is just a starting point.
- They're free, open-source services that render SVG stat cards from your public GitHub data. The images are fetched by GitHub's servers when someone views your profile — not by this tool. github-readme-stats is by @anuraghazra; streak-stats is by @DenverCoder1. Both are MIT-licensed.
- Your GitHub username is what appears in your profile URL: github.com/username. Your display name is the full name shown on your profile page — they can be completely different. The generator uses your username for stats card URLs and your display name for the README heading.
- The in-page preview renders the markdown output visually. Stats cards require GitHub's servers to fetch your live data and render an SVG — that only works once you paste the README into your GitHub profile. The preview uses a static placeholder to keep the generator 100% offline-capable.
- The snake animation (by @Platane/snk) requires a GitHub Actions workflow inside your special <username>/<username> repository to regenerate the SVG on every push. This is outside the scope of a pure markdown generator. We link to the Platane/snk documentation in the FAQ answer so you can wire it up separately after pasting your README.