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 (devduel) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

devduel

GitHub 프로필로 개발자 트레이딩 카드를 만들어보세요. RPG 스탯, 성격 유형, 1:1 대결까지.

npx devduel torvalds

╔══════════════════════════════════════════════╗
║  ★★★★☆ Epic                         LV.83  ║
║                                              ║
║  torvalds                                    ║
║  "The Relentless Shipper"                    ║
║                                              ║
║  C · C++ · Shell                             ║
║                                              ║
║  ATK ██████████  100   (198k ★)              ║
║  DEF ██████████  100   (52k forks)           ║
║  SPD ████████░░   84   (8 repos)             ║
║  INT ██████░░░░   55   (3 langs)             ║
║                                              ║
║  ✦ 238k followers  ✦ 198k stars              ║
║                                              ║
║                             devduel v0.1.0   ║
╚══════════════════════════════════════════════╝

어떻게 사용하나요?

준비물

Node.js 20 이상 (https://nodejs.org 에서 설치)
터미널 (Mac: Terminal, Windows: PowerShell, Linux: 아무 터미널)

Node.js가 설치되어 있는지 확인:

node --version
# v20.0.0 이상이면 OK

1단계: 내 카드 만들기

터미널을 열고 아래 명령어를 입력하세요. torvalds 자리에 아무 GitHub 아이디를 넣으면 됩니다.

npx devduel torvalds

npx는 npm 패키지를 설치 없이 바로 실행하는 명령어입니다. Node.js를 설치하면 자동으로 포함됩니다.

처음 실행하면 "Ok to proceed? (y)" 라고 물어봅니다. y를 누르면 됩니다.

2단계: 친구와 대결하기

두 개의 GitHub 아이디를 vs로 연결하면 1:1 대결 카드가 나옵니다.

npx devduel torvalds vs sindresorhus

╔══════════════════════ VS ══════════════════════╗
║                                                ║
║  torvalds              ⚔️     sindresorhus     ║
║  LV.83                        LV.79            ║
║  "The Relentless Shipper"     "The Type        ║
║                                Guardian"        ║
║                                                ║
║  ATK ✓ 100  ────►   95  ATK                   ║
║  DEF ✓ 100  ────►   88  DEF                   ║
║  SPD    84  ◄────   92  SPD ✓                  ║
║  INT    55  ◄────   90  INT ✓                  ║
║                                                ║
║  Winner: DRAW                                  ║
║                                                ║
╚════════════════════════════════════════════════╝

3단계: 자주 쓴다면 설치

매번 npx를 쓰기 귀찮다면 글로벌로 설치할 수 있습니다:

npm install -g devduel

설치 후에는 npx 없이 바로:

devduel torvalds
devduel torvalds vs gaearon

카드 읽는 법

스탯 (ATK / DEF / SPD / INT)

게임의 캐릭터 능력치처럼 GitHub 활동을 4가지로 분석합니다.

스탯	의미	기준
ATK (공격력)	얼마나 많이 만들었나	GitHub 스타 수 + 레포 수
DEF (방어력)	얼마나 신뢰받는가	포크 수 + 팔로워 수
SPD (속도)	얼마나 활발한가	최근 업데이트된 레포 비율 + 계정 나이
INT (지능)	얼마나 다양한가	사용 언어 수 + 레포 다양성

각 스탯은 0~100점이며, 막대그래프로 시각화됩니다:

ATK ████████░░  82    ← 82점, 10칸 중 8칸

레벨 (LV.)

4개 스탯의 평균입니다. LV.1 (신규) ~ LV.99 (전설).

칭호 (★ 등급)

등급	조건
★★★★★ Legendary	평균 스탯 80 이상
★★★★☆ Epic	평균 스탯 60 이상
★★★☆☆ Rare	평균 스탯 40 이상
★★☆☆☆ Common	평균 스탯 20 이상
★☆☆☆☆ Starter	모든 사람의 시작점

성격 유형

스탯과 주력 프로그래밍 언어를 기반으로 20가지 성격 중 하나가 배정됩니다:

성격	조건
The Relentless Shipper	ATK ≥ 80, SPD ≥ 80 (많이 만들고 빠르다)
The Polyglot Architect	DEF ≥ 80, INT ≥ 80 (신뢰받고 다양하다)
The Type Guardian	주력 언어: TypeScript
The Snake Charmer	주력 언어: Python
The Memory Sage	주력 언어: Rust
The Gopher	주력 언어: Go
The Enterprise Warrior	주력 언어: Java
The Frontend Wizard	주력 언어: JavaScript
The Bare Metal Hacker	주력 언어: C
The Performance Purist	주력 언어: C++
The Apple Artisan	주력 언어: Swift
The Android Knight	주력 언어: Kotlin
The Rails Rider	주력 언어: Ruby
The Web Survivor	주력 언어: PHP
The Speed Demon	SPD ≥ 90
The Language Collector	INT ≥ 90
The Star Farmer	ATK ≥ 90
The Community Pillar	DEF ≥ 90
The Silent Observer	ATK < 30, SPD < 30
The Versatile Coder	기본값

대결 모드 읽는 법

ATK ✓ 100  ────►   95  ATK

────► 화살표 방향 = 이긴 쪽
✓ 표시 = 해당 항목 승자
4개 항목 중 더 많이 이긴 쪽이 최종 승자
2:2면 DRAW (무승부)

사용 예시

# 내 카드 보기
npx devduel anhanho

# 유명 개발자 카드 보기
npx devduel torvalds          # 리눅스 만든 사람
npx devduel gaearon           # React 핵심 개발자
npx devduel sindresorhus      # npm 패키지 킹
npx devduel yyx990803         # Vue.js 만든 사람
npx devduel tj                # Express.js 만든 사람

# 대결
npx devduel torvalds vs yyx990803
npx devduel gaearon vs sindresorhus

자주 묻는 질문

Q: GitHub 계정이 필요한가요? A: 아니요. GitHub 공개 API를 사용하므로 계정 없이도 됩니다. 다만 시간당 60번까지 요청할 수 있습니다.

Q: 60번 넘으면 어떻게 하나요? A: GitHub 토큰을 설정하면 시간당 5,000번까지 가능합니다:

export GITHUB_TOKEN=ghp_your_token_here
npx devduel torvalds

토큰 발급: https://github.com/settings/tokens → "Generate new token" → public_repo 권한만 체크

Q: 비공개 레포도 분석하나요? A: 아니요. 공개 레포만 분석합니다. 비공개 레포는 포함되지 않습니다.

Q: 스탯이 낮은데요? A: 공개 레포와 스타/포크/팔로워 기준입니다. 실력과는 무관하며, 재미로 보는 카드입니다.

Development

git clone https://github.com/anhanho/devcard
cd devcard
npm install
npm run dev -- torvalds           # 개발 모드로 실행
npm run dev -- torvalds vs tj     # 대결 테스트
npm run build                     # 프로덕션 빌드
npm run lint                      # 타입 체크

License

MIT