Free & Open Source

Make your
GitHub README
stand out.

Generate beautiful stats cards and social link banners in seconds. Configure in the builder, copy one line, paste into your README.

2
Widget types
9
Built-in themes
110
Automated tests
10
Social platforms
readme-maker-ashen.vercel.app/builder
GitHub stats card preview
Live SVG — updates with your real GitHub data

Features

Everything you need for a sharp README

Every setting you change in the builder is encoded into the URL. The API produces exactly what you saw in the preview — no surprises.

📊
GitHub Stats Card
11 selectable metrics. Row list or 3×N grid layout. Customise title, icons, border, and more.
🔗
Social Links Card
Add any profile URL and the card auto-detects the platform. Flow or grid layout. Drag to reorder.
🎨
9 Themes + Custom
Pick from 9 polished presets or create your own with 6 independent color slots.
🔵
Icons Only Mode
Compact square icon badges with no label text — great for minimal profiles.
⚡
Serverless — zero config
Runs on Vercel. No backend to manage. Embed a URL and it just works.
🔒
Single URL contract
Preview and embed are generated from the exact same URL. What you configure is what your README shows.

Widgets

Two widgets, endless configurations

Each widget is a plain SVG served over HTTP — works in any Markdown renderer, including GitHub READMEs.

Stats Card — Standard SVG
GitHub Stats Card
Stats Card — Grid layout SVG
GitHub Stats Grid Card
Social Links — Flow No token
Social Links Card
Social Links — Grid + Icons only No token
Social Links Grid Icons Only

Coming soon

More widgets on the way

The builder is growing. These are next in line — follow the repo to get notified when they drop.

📈 In progress
Top Languages Card
Bar chart of your most used languages across all repos. Filterable, sortable, themed.
🔥 Planned
Streak Counter
Current streak, longest streak, and total contributions — the card everyone puts in their README.
🏆 Planned
Achievements Card
GitHub trophies and milestones — stars earned, PRs merged, issues closed — displayed as badges.
📅 Planned
Contribution Heatmap
52-week activity grid styled to match your theme. The classic GitHub graph, but yours to embed anywhere.
⭐ Planned
Pinned Repos Card
Showcase your best projects with stars, forks, language, and description — all in one card.
✨ Idea
Got an idea?
Have a widget in mind that's not listed here? Open an issue and let's build it together.
Suggest a widget →

How it works

Three steps, one URL

No accounts, no sign-in. Just configure, copy, and paste.

1
Open the builder
Enter your GitHub username, pick a theme, select your stats, and tweak every option in real time.
2
Copy the embed
Grab the Markdown, HTML, or raw URL from the output panel. The URL encodes your entire configuration.
3
Paste into your README
Drop it into your GitHub profile README. The SVG renders live with your real data, cached for 5 minutes.
README.md Markdown

![GitHub Stats](https://readme-maker-ashen.vercel.app/api/stats?username=yourname&theme=midnight&radius=8)


![My Links](https://readme-maker-ashen.vercel.app/api/social-card?link=https://github.com/yourname&title=Connect+with+me&centreTitle=1)

Themes

9 built-in themes

Pick from 9 polished presets or build your own in the builder — every color slot (background, border, title, text, value, accent) is independently configurable. Custom themes are encoded directly into the embed URL, so nothing is saved server-side.

default
ocean
sunset
cyberpunk
midnight
tokyoNight
emerald
sunsetGlow
dark

Open Source

Built in the open — contributions welcome

Readme Maker is fully open source. Whether it's a new theme, a platform badge, a bug fix, or just a ⭐ star — every bit helps.

🎨
Add a theme
Drop a new entry into src/core/themes.js with 6 hex values and it automatically appears in the builder and as a URL param.
🔗
Add a platform
Add a new entry to src/widgets/social-links/platforms.js with a match pattern, color, and SVG icon path.
📊
Add a metric
Extend stat-definitions.js and the GitHub GraphQL query to surface a new stat in the stats card.
🐛
Report a bug
Found something broken? Open an issue on GitHub with steps to reproduce and we'll get it sorted.
Ready to contribute? Fork, branch, build, PR. The repo has a full test suite and a local dev server to make it easy.
View on GitHub

Your README is one click away.

Free, open source, and ready to use. No account required.

Readme Maker
GitHub widget generator
SVG Widget Lab
Stats Card Builder

Build your embed

Configure, preview, and copy a production-ready GitHub stats card in seconds.

Live preview refreshes automatically
Embed type
GitHub username
Ready — enter a username and hit Load
Default
Create custom theme
Choose stats
6
Live preview

Use your embed

Copy any format into your README, website, or profile.

Link
Markdown
HTML