srizzon/git-city

GitHub 프로필을 3D 픽셀 아트 건물로 변환해 인터랙티브 도시에서 개발자들을 탐험하는 비주얼라이제이션

완성 앱조건 있음 · AGPL-3.0웹·Next.js·풀스택난이도
5,667+0이번 주2816TypeScript
데모·홈페이지 열기thegitcity.com
중간맛 분석

스택: Next.js 16 + Three.js + React Three Fiber + Supabase (PostgreSQL + GitHub ) 난이도: 중상 (3D 렌더링, 백엔드 인증 필요) 바로 쓸 수 있나: 네. 로컬 Supabase 스택으로 원격 계정 없이 개발 가능 데모: thegitcity.com에서 실제 도시 탐험 가능 (GitHub 로그인으로 자신의 건물 생성)

이런 레포예요

이럴 때 쓰면 좋아요

  • GitHub 프로필을 독특한 3D 건물로 시각화해 포트폴리오 공유
  • 개발자 커뮤니티 내 랭킹 및 비교 시스템 구현
  • OSS 기여자 인정 및 게임화 시스템 (업적, 리더보드)

핵심 기능

GitHub 기여도 기반 3D 픽셀 아트 건물 생성자유로운 카메라 조종으로 3D 도시 탐험프로필 커스터마이징 (크라운, 오라, 지붕 효과 등)개발자 비교 모드 및 프로필 공유 카드

대안 대비 차별점

로컬 Supabase 스택 지원으로 GitHub OAuth 설정 없이 즉시 개발 가능하며, 직관적인 메트릭 매핑(커밋→높이, 저장소→너비, 스타→창 밝기)과 소셜 기능(kudos, 선물, 활동 피드)으로 단순 통계 시각화를 넘어선 인터랙티브 커뮤니티 경험 제공.

준비물
  • Node.js
  • npm 또는 yarn
  • Docker 및 Supabase CLI (로컬 개발 시)
  • GitHub 계정
바로 시작하기
  1. 저장소 클론
git clone https://github.com/srizzon/git-city.git
cd git-city
  1. 의존성 설치
npm install
  1. 환경변수 파일 생성 (Linux/macOS)
cp .env.example .env.local

Windows PowerShell:

Copy-Item .env.example .env.local

  1. .env.local 파일을 열고 필수 값 입력 (Supabase URL, 익명 키, 서비스 롤 키, GitHub 토큰)

  2. 개발 서버 실행

npm run dev
  1. http://localhost:3001 브라우저에서 접속

선택: 로컬 Supabase 사용 (원격 계정 불필요)

  • Supabase CLI와 Docker 설치 후 supabase start 실행
  • 출력된 로컬 URL과 키를 .env.local에 입력
  • GitHub OAuth 대신 빌트인 dev 로그인 사용 (GitHub 유저명만 입력)
별 추이 · 7일
5,667+0 / 7일
활용성 · 따라 만들기 좋은가
샘플 점수 14/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2026년 생성

AI가 README 기반으로 요약했습니다 · 원문 보기