gitmon cards — Turn GitHub profiles into dynamic trading…

Pitch

Description

Comments

About this project

Gitmon Cards transform GitHub profiles and repositories into collectible trading cards with a static image URL. No login is required, and the cards are always up to date. With various rarity tiers and unique designs based on dominant languages, these cards are perfect for showcasing GitHub contributions in an engaging way.

Gitmon Cards transforms GitHub profiles and repositories into collectible trading cards featuring dynamic, real-time updates. Designed with a focus on engaging visuals, each card is generated as a static image URL that can be effortlessly embedded in any README file without requiring any login.

Features

Dynamic Content: Each card showcases real-time data sourced from GitHub, ensuring that information such as profile stats and repository contributions is always current.
Variety of Types: Cards represent 18 distinct energy types based on the most dominant programming languages, each depicted with original artwork and icons.

Card Elements

Every card incorporates essential stats derived from GitHub API data through well-documented formulas:

Element	Source
Type	Dominant language weighted by stars
HP	Profile: calculated over stars, followers, and repos; Repo: logarithmic based on stars and forks
Attacks	Profile: most-starred repositories; Repo: key human contributors
Weakness	Profile: developer's second language; Repo: type chain
Resistance	Type effectiveness chain
Retreat	Profile: account age; Repo: open issue count
Rarity	Composite score on the Pokémon TCG rarity ladder
Tag	The strongest axis of the profile, e.g., `HUB`, `LTS`
Serial Number	Immutable identifier assigned during creation

The rarity system includes multiple tiers that enhance card design through various art treatments, ensuring that each card's visual appeal matches its rarity level.

Versatile Usage

Cards can be collected, shared, and showcased in multiple formats, making them suitable for social media and collaborative documentation. Users can easily:

Download PNG files for personal use or sharing on social feeds.
Share links via native applications, ensuring compatibility across platforms.
Generate Markdown snippets for seamless integration into README files.

Architecture and Technology

Gitmon Cards leverages modern web technologies for optimal performance:

Built on Next.js 16 and React 19, ensuring fast and efficient rendering.
Uses Redis for data caching, enabling quick access to frequently requested information.
Enhanced image generation capabilities provided by next/og and sharp for composition.

For developers interested in contributing, comprehensive documentation and guidelines are available within the repository, ensuring a smooth onboarding process. Visit the project's documentation for more details and specifications.