{"id":26815188,"url":"https://github.com/hobby2025/please_readme","last_synced_at":"2026-02-24T15:01:45.671Z","repository":{"id":285028804,"uuid":"955743289","full_name":"Hobby2025/please_readme","owner":"Hobby2025","description":"GitHub 프로필 이미지 생성기","archived":false,"fork":false,"pushed_at":"2025-06-01T13:29:12.000Z","size":46896,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-25T21:43:00.942Z","etag":null,"topics":["github","nextjs","readme"],"latest_commit_sha":null,"homepage":"https://please-readme.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Hobby2025.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-27T05:59:52.000Z","updated_at":"2025-06-01T13:29:15.000Z","dependencies_parsed_at":"2025-03-29T02:29:16.103Z","dependency_job_id":"230974e9-0df4-4966-a4c1-6b294f31d073","html_url":"https://github.com/Hobby2025/please_readme","commit_stats":null,"previous_names":["hobby2025/please_readme"],"tags_count":67,"template":false,"template_full_name":null,"purl":"pkg:github/Hobby2025/please_readme","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hobby2025%2Fplease_readme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hobby2025%2Fplease_readme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hobby2025%2Fplease_readme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hobby2025%2Fplease_readme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hobby2025","download_url":"https://codeload.github.com/Hobby2025/please_readme/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hobby2025%2Fplease_readme/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29786978,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-24T10:45:18.109Z","status":"ssl_error","status_checked_at":"2026-02-24T10:45:09.911Z","response_time":75,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["github","nextjs","readme"],"created_at":"2025-03-30T02:18:36.002Z","updated_at":"2026-02-24T15:01:45.635Z","avatar_url":"https://github.com/Hobby2025.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://github.com/user-attachments/assets/2cd1f193-420c-4eb9-b6db-27497f437ccc\" height=\"120\" loading=\"eager\" alt=\"Please Readme 로고\" fetchpriority=\"high\"\u003e\n\n\u003e GitHub 프로필 정보와 활동 통계를 기반으로 커스터마이징 가능한 이미지 카드를 생성하는 웹 애플리케이션입니다.\u003cbr\u003e\n\u003e `Vercel OG Image Generation`을 사용하여 서버사이드에서 이미지를 생성합니다.\n\n## 📌 기능\n\n- GitHub 사용자 정보 및 활동 통계 (커밋, 스타, PR, 이슈) 표시\n- 프로필 정보 (이름, 소개) 커스터마이징\n- 기술 스택 목록 표시\n- 왜곡 없는 이미지 표시\n- API 엔드포인트를 통한 프로필 카드 이미지 생성 (`/api/card?username=...`)\n- 생성된 이미지 미리보기 및 마크다운 코드 복사 기능\n\n## 📌 기술 스택\n\n- `Next.js`\n- `React`\n- `TypeScript`\n- `Tailwind CSS`\n- `@vercel/og` (Satori) for Image Generation\n- `GitHub API`\n\n## 📌 시작하기\n\n1. 저장소 클론\n```bash\ngit clone https://github.com/yourusername/github-profile-card-generator.git\ncd github-profile-card-generator\n```\n\n2. 의존성 설치\n```bash\nnpm install\n```\n\n3. 개발 서버 실행\n```bash\nnpm run dev\n```\n\n4. 브라우저에서 확인\n```\nhttp://localhost:3000\n```\n\n## 📌 환경 변수\n\n`.env.local` 파일을 생성하고 다음 환경 변수를 설정하세요:\n\n```\nGITHUB_TOKEN=your_github_token\nNEXT_PUBLIC_API_BASE_URL=your_deployment_url (e.g., http://localhost:3000 for development)\n```\n\n## 📌 프로필 카드 사용법\n\n1. 웹 애플리케이션에서 GitHub 사용자명과 기타 정보를 입력합니다.\n2. '카드 생성 / 업데이트' 버튼을 클릭하여 카드를 생성합니다.\n3. '마크다운 복사' 버튼 또는 높이조절이 가능한 'HTML 복사' 버튼을 사용하여 마크다운 코드를 복사합니다.\n4. GitHub 프로필 README.md에 코드를 붙여넣어 카드를 표시합니다.\n\n## 📌 카드 사양\n\n- **지원 기술 스택**: React, TypeScript, JavaScript, Python, Java 등 다양한 기술 스택 아이콘 지원\n- **랭크 표시**: GitHub 활동에 따른 랭크 시스템 (S, A+, A, A-, B+, B, B-, C+, C)\n\n## 📌 버전 관리\n\n커밋 메시지에 따라 자동으로 버전이 업데이트됩니다:\n\n1. **일반 업데이트** (z 증가)\n   - 일반적인 커밋\n   - 예: `fix: 버그 수정`\n\n2. **마이너 업데이트** (y 증가)\n   - 커밋 메시지에 `#minor` 포함\n   - 예: `feat: 새로운 기능 추가 #minor`\n\n3. **메이저 업데이트** (x 증가)\n   - 커밋 메시지에 `#major` 포함\n   - 예: `feat: 주요 기능 변경 #major`\n\n4. **버전 업데이트 제외**\n   - 커밋 메시지에 `#noversion` 포함\n\n## 📌 최근 업데이트\n\n- 프로필 카드 디자인 개선 (더 큰 아이콘 및 텍스트)\n- 이미지 표시 문제 해결 (종횡비 유지하여 왜곡 방지)\n- 기술 스택 배지 시각적 개선\n- 폰트 개수 확장\n- 스택 개수에 따른 동적인 이미지 높이 조절\n\n## 📌 알려진 이슈\n[이슈보드](https://github.com/Hobby2025/please_readme/discussions/1)\n\n## 📌 라이선스\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhobby2025%2Fplease_readme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhobby2025%2Fplease_readme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhobby2025%2Fplease_readme/lists"}