Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@mightbeandrew/devcard) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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

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

License

MIT

@mightbeandrew/devcard