@mightbeandrew/devcard

devcard

Generate a beautiful developer trading card from any GitHub profile — one command, zero setup.

Quick Start

npx @mightbeandrew/devcard YOUR_GITHUB_USERNAME

That's it. No install, no config. A PNG is saved to your current directory.

Example

npx @mightbeandrew/devcard torvalds

Generates devcard-torvalds.png — a full trading card with stats, top repos, and languages.

Features

• Trading card aesthetic — HP, ATK, DEF, SPD, LVL stats mapped from real GitHub data
• Rarity system — Common → Uncommon → Rare → Ultra Rare → Secret Rare → Legendary
• Auto-themed — card color scheme matches your dominant language (JS = Electric, Python = Fire, etc.)
• Terminal preview — see a rich terminal preview before the PNG saves
• Zero config — works with any public GitHub profile, no auth required
• Fast — 4 API calls, 1-hour local cache

Themes

Theme	Auto-detected for
electric	JavaScript, TypeScript
fire	Python, Ruby
water	Go, Kotlin, Swift, Java
earth	C, C++, Rust, Assembly
psychic	Haskell, Scala, Clojure, Elixir
dark	Default / C#, PHP, Shell
light	Light mode
holo	Holographic (force with --theme holo)

Options

npx @mightbeandrew/devcard <username> [options]

Options:
  -o, --output <path>    Output file path (default: devcard-<username>.png)
  -t, --theme <theme>    Force a theme (auto|dark|light|holo|fire|water|electric|psychic|earth)
  --token <token>        GitHub token for higher rate limits (or set GITHUB_TOKEN)
  --no-preview           Skip terminal preview
  --open                 Auto-open the PNG after saving
  --no-cache             Bypass the 1-hour local cache
  --copy                 Copy file path to clipboard
  -v, --version          Show version
  -h, --help             Show help

Stat Mapping

Card Stat	GitHub Data	Formula
❤ HP	Total stars	log scale (max 50k)
⚔ ATK	Total commits (approx)	log scale (max 100k)
🛡 DEF	Followers	log scale (max 100k)
📅 SPD	Account age	linear (max 15 years)
📦 LVL	Public repos	log scale (max 1000)

Rarity Tiers

Tier	Criteria
COMMON	< 100 followers & < 50 stars
UNCOMMON	< 1k followers & < 500 stars
RARE	Default for active developers
ULTRA RARE ✦	> 10k followers or > 5k stars
SECRET RARE ✦✦	> 100k followers or > 50k stars
LEGENDARY ✦✦✦	> 150k followers or > 100k stars

GitHub Profile README

After generating your card, add it to your profile README:

![My DevCard](https://raw.githubusercontent.com/YOUR_USERNAME/YOUR_USERNAME/main/devcard-YOUR_USERNAME.png)

• Run npx devcard YOUR_USERNAME
• Commit devcard-YOUR_USERNAME.png to your profile repo
• Add the markdown above to your README.md

Rate Limits

Without a token: 60 requests/hour (1 card per run = 4 requests — plenty for normal use).

For higher limits: npx devcard username --token YOUR_TOKEN or set GITHUB_TOKEN env var.

Get a token (no scopes needed for public data): https://github.com/settings/tokens

Share

Post your card with #devcard on Twitter/X or LinkedIn!

License

MIT