coolreadme.xyz

README cards that don't suck

4 followers

README cards that don't suck

4 followers

Every GitHub README has the same stats card, streak flames, and badge wall. coolreadme lets you paste real stuff from your life (a film you watched, a tweet you liked, your npm package, a Twitch stream) and get back a Netflix or X-style card. 30+ types. Animated pet streaks (cat, dog, fox, penguin, owl) evolve through 9 stages on live GitHub data. /llms.txt endpoint so Claude or ChatGPT writes the markdown for you. No signup, no database, edge-rendered with Satori. Free for personal use.

Free

Launch tags:Design Tools•Developer Tools•GitHub

Launch Team / Built With

Wispr Flow: Dictation That Works Everywhere — Stop typing. Start speaking. 4x faster.

Stop typing. Start speaking. 4x faster.

Promoted

Maker

📌

Hey Product Hunt, I'm Yerdaulet (ED), solo dev, shipping for devs and the occasional vibecoder. I built coolreadme.xyz because every GitHub README on the planet looks the same. Look at any dev profile. You'll see three things: the A+ rank circle from anuraghazra/github-readme-stats, the orange flame columns from DenverCoder1/github-readme-streak-stats, and a wall of rainbow badges from shields.io or skill-icons.dev. Then somewhere "Profile views: 11" and "Hi, I'm passionate about turning coffee into code ☕". Same setup since 2018. Your GitHub README is the most-read thing you own. Recruiters land there. So do collaborators, and anyone else who looks you up. And right now it looks exactly like the next person's. What I wanted was a README that actually felt like me. The series I'm watching (Supernatural). A tweet I want to pin with the real engagement on it. The npm package I just shipped, with live download numbers. My contribution streak rendered as a fox that evolves the longer I keep going, instead of a wall of green squares I share with every other GitHub user. So coolreadme.xyz is a card builder where you paste the things you already have and get a card back. Paste your GitHub username, you get an animated pet streak that auto-pulls your contribution history. Type a film, you get a Netflix hero card with the real TMDB poster. Paste a tweet, an X card with the verified check and engagement counts. Drop a release URL, an Instagram-style launch post. Drop a Twitch link, a live-stream card with viewer count. Drop an npm package name, a docs card with the current version and weekly downloads. There are 30+ card types right now, no signup, no database, nothing asks for your token. You paste a thing, you get a card. Two parts worth flagging. - The pet streaks. Animated SVG creatures (cat, dog, fox, penguin, owl) that evolve through 9 stages as your streak grows: seed, sprout, grind, streak, god, legend, mythic, eternal, transcended. Hit 100 days and your pet gets a crown. All driven by live GitHub contribution data. Started as a side joke and turned into the cards people screenshot most. - The LLM-first endpoint. There's a /llms.txt at the root. You can tell Claude or ChatGPT "read coolreadme.xyz/llms.txt and add a cinematic card for my username" and it writes the correct markdown. Saves the trip to the generator if you live in your editor with an AI assistant open. The infra is dumb on purpose. No database, no auth, no API keys, and personal use isn't rate-limited. Everything renders at the edge with Satori or raw SVG, cached hard. It's fast everywhere because there's nothing to be slow. Service is closed source, companion repo yerdaulet-damir/awesome-github-readme is open, PRs welcome there. I'd love brutal feedback. Card types you wish existed. Anything slow, broken, or weird. Whether the LLM workflow actually works in your editor stack. coolreadme.xyz - github.com/yerdaulet-damir (dogfooding it on my own profile) - github.com/yerdaulet-damir/awesome-github-readme Going to be in the comments all day. Thanks for hunting.

Report

17d ago

RiteKit Company Logo API

@aimyerdaulet This is a genuinely fresh take on the README problem—the observation about those three components being identical across profiles is spot on. Building identity into what's essentially become a template is a smart angle, and the fox streak idea is way more memorable than another contribution graph.

Report

15d ago

Maker

@osakasaul Thanks Saul. Honestly that's the whole pitch in one observation. Once you see those 3 components on every profile you can't unsee them. They were great in 2018, just became the dev equivalent of "this site uses cookies" by now, noise everyone scrolls past.

FWIW the fox is the most screenshotted card we have. People want their stats to have a face apparently.

Random, your logo API thing got me thinking. There's a card I haven't built yet but probably should, a "previously at / now at" thing for the work history section of READMEs. Most devs either skip that part or paste shields.io company badges that look rough.

Report

15d ago

Forum Threads

p/coolreadme-xyz

•

17d ago

What card would you actually use on your GitHub README that doesn't exist yet?

I'm shipping coolreadme.xyz on PH this Saturday it's a builder for GitHub README cards. 30+ types right now: Netflix, X, YouTube, TikTok, Steam, animated pet streaks (cat, dog, fox, penguin, owl that evolve through 9 stages on your contribution data), plus a /llms.txt so Claude or ChatGPT can write the markdown for you.

But I want to know what's missing.

Something tied to a tool you use daily that's never been embeddable before? A specific format you've seen on Twitter or Reddit that would work as a static card? Something silly that no "serious" generator would build?

Drop ideas below. If something is good and shippable in an afternoon, I'll have it live before Saturday.

View all