UStackUStack
GitCity icon

GitCity

GitCity는 GitHub 공개 기여 이력을 등각 3D 도시 스카이라인으로 변환하고, README·포트폴리오에 임베드 가능한 SVG를 제공합니다.

GitCity

GitCity란?

GitCity는 사용자의 GitHub 기여 이력을 인터랙티브 등각 3D 도시 스카이라인으로 변환합니다. 핵심 아이디어는 공개 기여한 각 날짜가 “건물”이 되고, 커밋 활동이 높이에 영향을 주어 그리드 대신 시각적으로 탐색할 수 있다는 점입니다.

GitHub 사용자들이 기여 데이터를 더 매력적인 형식으로 제시하고자 할 때—예를 들어 README나 개발자 포트폴리오에 SVG를 임베드—GitHub 사용자명을 입력하는 것 외에 별도 설정 없이 사용할 수 있도록 설계되었습니다.

주요 기능

  • GitHub 기여 기반 인터랙티브 등각 3D 도시: 공개 기여 활동에 따라 스카이라인을 구축해 패턴을 한눈에 파악할 수 있습니다.
  • 운전 가능한 도시 시뮬레이션: 시뮬레이션 모드를 통해 “거리 수준”에서 도시를 탐색하며 스카이라인을 공간적으로 살펴볼 수 있습니다.
  • 테마 전환 (6가지 테마): Matrix, Noir, Aurora, Ocean, Gold, Ice 등 다양한 미적 취향에 맞춘 테마 비주얼을 제공합니다.
  • 연도, 월, 주별 시간 필터링: 전체 이력 보기 대신 특정 기간으로 시각화를 제한할 수 있습니다.
  • GitHub README 및 포트폴리오용 임베드 가능한 SVG: 개발자 프로필과 프로젝트 페이지에 시각화를 포함할 수 있는 SVG를 생성합니다.
  • GitHub 사용자명으로 제로 설정: 입력한 사용자명으로 공개 기여 데이터를 자동 가져와 설정 단계를 최소화합니다.

GitCity 사용 방법

  1. GitCity를 열고 GitHub 사용자명을 입력합니다.
  2. GitCity가 공개 기여 데이터를 가져와 커밋이 있는 날짜를 건물로 렌더링합니다.
  3. 테마 컨트롤로 외관을 변경하고 필터 컨트롤연도, 월, 주에 초점을 맞춥니다.
  4. 공유하려면 임베드 가능한 SVG 옵션을 사용해 GitHub README나 개발자 포트폴리오용 임베드를 생성합니다.
  5. (선택) 시뮬레이션 모드로 전환해 거리 수준에서 도시를 탐색합니다.

사용 사례

  • 개인 GitHub README 시각화: 생성된 SVG를 README에 임베드해 정적 차트 대신 3D 스카이라인으로 기여 활동을 표시합니다.
  • 포트폴리오 제시: 개발자 포트폴리오 페이지에 도시 시각화를 포함해 코딩 활동을 한눈에 보여줍니다.
  • 시간 범위 검토 (월간/주간): 월이나 주 단위로 필터링해 짧은 기간 동안 기여량 변화를 검토합니다.
  • 미학에 따른 활동 스토리텔링: 프로젝트 페이지나 소셜 프로필 등 맥락에 따라 테마(Noir나 Aurora 등)를 변경합니다.
  • 기여 탐색 “산책”: 시뮬레이션 모드로 도시를 탐색하며 커밋 밀도 패턴을 시각적으로 해석합니다.

자주 묻는 질문

  • GitCity는 어떤 데이터를 사용하나요? 입력한 사용자명의 공개 GitHub 기여 데이터를 가져옵니다.

  • GitCity는 커밋을 3D 도시로 어떻게 매핑하나요? 페이지에 따르면 커밋이 있는 각 날짜가 건물이 되고, 커밋이 많을수록 타워가 높아집니다.

  • 특정 기간으로 시각화를 제한할 수 있나요? 네. 연도, 월, 주 필터를 제공합니다.

  • 다른 페이지에 시각화를 임베드할 수 있나요? 네. 임베드 가능한 SVG를 제공하며 GitHub README개발자 포트폴리오용으로 적합합니다.

  • GitHub 사용자명 외에 설정이 필요한가요? 페이지에서 제로 설정으로 설명하며 GitHub 사용자명 입력만 필요합니다.

대안

  • GitHub 기여 시각화 (2D 히트맵/차트): 3D 도시와 시뮬레이션 대신 그리드나 차트로 기여를 제시합니다. 더 간단하지만 공간적이지 않습니다.
  • 포트폴리오/정적 GitHub 통계 위젯: 배지나 정적 요약을 생성하는 도구는 임베드가 쉽지만, 여기 설명된 운전 도시 경험이나 시간 범위 3D 뷰를 제공하지 않습니다.
  • GitHub API 데이터 기반 커스텀 시각화: DIY 방식으로 맞춤 비주얼(3D 포함)을 만들 수 있지만, 제로 설정 워크플로 대신 사용자에게 설정과 유지보수 부담을 줍니다.
GitCity | UStack