README.gen

Pro · Widget gallery

Widgets the generator doesn't ship

The basic generator covers the core stats cards. This is the rest — the trophies, graphs, badges, and dynamic widgets that make a profile yours. Copy the Markdown, swap USERNAME for your handle, paste into your README.

Stats & trophy cards

The numbers most profiles lead with. Theme them to match your README.

GitHub stats card

Stars, commits, PRs, and issues in one card. The `theme` param ties it to your palette.

![Stats](https://github-readme-stats.vercel.app/api?username=USERNAME&show_icons=true&theme=tokyonight)

Top languages

Compact layout reads better in a profile than the default donut.

![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=USERNAME&layout=compact&theme=tokyonight)

Trophy case

A row of achievement trophies. Pin `--column` so it never wraps awkwardly.

![Trophies](https://github-profile-trophy.vercel.app/?username=USERNAME&theme=tokyonight&column=7&margin-w=8)

Activity & streaks

Momentum at a glance — the widgets that reward showing up.

Streak stats

Current and longest contribution streaks. The most-clicked widget on most profiles.

![Streak](https://streak-stats.demolab.com?user=USERNAME&theme=tokyonight)

Contribution activity graph

A line graph of the last 31 days of activity. Great above the fold.

[![Activity](https://github-readme-activity-graph.vercel.app/graph?username=USERNAME&theme=tokyo-night)](https://github.com/USERNAME)

Badges & shields

Tech stack and social links as flat badges. Consistency beats quantity.

Tech badge (flat-square)

Pick one badge style and use it everywhere. Swap logo + colors per tool.

![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white)

Social / for-the-badge

Bigger badges for the "connect with me" row at the bottom of a profile.

[![LinkedIn](https://img.shields.io/badge/LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://linkedin.com/in/USERNAME)

Profile views counter

A lightweight view counter. Honest vanity metric; keep it small.

![Views](https://komarev.com/ghpvc/?username=USERNAME&style=flat-square&color=00d4ff)

Dynamic & fun

The widgets that make a profile feel alive. Use sparingly — one is plenty.

Typing SVG header

An animated typing banner. Comma-separate lines; keep them short.

![Typing](https://readme-typing-svg.demolab.com?font=Fira+Code&size=24&duration=3000&color=00D4FF&lines=Full-stack+engineer;Open-source+maintainer)

Contribution snake

The snake eats your contribution grid. Needs a GitHub Action to regenerate the SVG daily.

![Snake](https://raw.githubusercontent.com/USERNAME/USERNAME/output/github-contribution-grid-snake-dark.svg)

Spotify now-playing

Live "currently listening" card via a small serverless relay. A tasteful personal touch.

[![Spotify](https://spotify-github-profile.kittinanx.com/api/view?uid=USERNAME&cover_image=true&theme=default)](https://spotify-github-profile.kittinanx.com/api/view?uid=USERNAME&redirect=true)

All widgets are third-party services — review each project's terms before relying on it in production. Swap any URL's theme to match your README.