About this tool
Generate a GitHub profile README with skill badges, project cards, stats widgets and contact links.
This generator builds a complete GitHub profile README — the README.md that renders on your profile when placed in a repository named exactly after your username — with shields.io skill badges, a project list, github-readme-stats widgets and contact links. It is aimed at developers polishing their GitHub for job applications, and it validates your username against GitHub's actual rules (1–39 alphanumeric characters or single hyphens) before generating widget URLs.
Open Developer Portfolio Readme Generator on AltFTool — it loads instantly in your browser.
Paste your code or data sample into the workspace.
Pick the format, conversion, or analysis you need.
Copy the polished result straight back into your project.
Uses the documented username/username profile-README feature and validates usernames against GitHub's naming rules.
Stats and top-language cards come from the open-source github-readme-stats service, which needs no authentication for public data.
The README is assembled in your browser — nothing you type is uploaded anywhere.
Create a public repository with exactly the same name as your username — for example github.com/octocat/octocat — and add a README.md to it. GitHub then renders that README at the top of your profile page; this generator produces the Markdown to paste in.
Embed an image from the open-source github-readme-stats project: . It works without any token for public repositories; private-repo stats require deploying your own instance with a personal access token.
A one-line headline, a short bio, a skills section, two to five highlighted projects with links, and a way to reach you — roughly in that order, since recruiters skim top-down. Keep it under one screen; a profile README is a landing page, not a résumé.
Up to 39 characters, using only letters, digits and hyphens; hyphens cannot lead, trail or repeat consecutively. This tool applies that exact rule before building your stats-widget and profile URLs, so a typo surfaces immediately instead of as a broken image.