github-visitor-counter

GitHub Visitor Counter는 GitHub 프로필 README에 방문자의 국가 국기를 표시하는 오픈 소스 도구입니다. Vercel에 배포된 서버리스 API로 실행되며, 유지 관리나 계정 등록이 필요하지 않습니다. ## 개요 사용자는 GitHub 프로필에 단일 마크다운 이미지 태그를 추가하여 방문자의 유입 국가를 표시할 수 있습니다. 이 서비스는 Flag Counter API와 통합되어 Top Countries, Flag Map, Flags From (US/CA), Mini Counter의 네 가지 표시 모드를 제공합니다. ## 주요 기능 - **한 줄 통합**: 모든 GitHub 프로필 README에 마크다운 한 줄만 추가하면 됩니다. - **등록 불필요**: GitHub 사용자 이름만 있으면 즉시 작동합니다. - **네 가지 표시 모드**: 상위 국가 목록, 국기 지도 시각화, 위치 필터링 국기, 컴팩트한 미니 카운터를 제공합니다. - **다양한 테마**: Default, Dark, GitHub, GitHub Dark, Transparent 테마를 지원합니다. - **저장소별 카운터**: 개별 저장소의 방문 횟수를 별도로 추적할 수 있습니다. - **공식 ID 호환**: 대시보드 통합을 위해 기존 Flag Counter ID를 지원합니다. - **실시간 설정 도구**: 라이브 미리보기가 가능한 대화형 웹 대시보드를 제공합니다. - **파워 사용자를 위한 단축키 및 설정 가져오기/내보내기** 기능을 제공합니다. ## 표시 모드 1. **Top Countries**: 방문자 수 순으로 정렬된 국기 그리드 2. **Flag Map**: 방문자 위치의 지리적 지도 시각화 3. **Flags From**: 지정된 국가(미국 또는 캐나다)의 방문자만 표시하는 필터링된 국기 4. **Mini Counter**: 국기 수 또는 페이지 뷰를 표시하는 컴팩트한 디스플레이 ## 기술 스택 Next.js 15, React 19, TypeScript, Tailwind CSS로 구축되었으며, 글로벌 CDN 캐싱과 함께 Vercel에 배포되었습니다. ## 사용법 GitHub 프로필 README에 추가하세요: ```  ``` 선택적 매개변수로는 `displayMode`, `theme`, `columns`, `maxflags`, `label`, 사용자 정의 색상 등이 있습니다. 저장소별 추적은 `repo` 또는 `username/repo` 형식을 사용합니다. 기존 Flag Counter 사용자는 `counterId` 매개변수를 전달할 수 있습니다. ## 셀프 호스팅 이 프로젝트는 MIT 라이선스로 제공되며, Vercel 배포 또는 `npm run dev`를 통한 로컬 개발로 셀프 호스팅할 수 있습니다. 모든 소스 코드는 저장소에서 확인할 수 있습니다.