GitHub 저장소용 공유 이미지 미리보기를 생성하고, 실시간 통계와 로고, 폰트, 배경 패턴을 제공합니다.
badges/shields
Shields.io는 README와 웹 페이지에 사용할 간결한 SVG 및 래스터 상태 배지를 생성하는 서비스이자 NPM 라이브러리입니다.
- 스타
- 27,366
- 포크
- 5,632
- 열린 이슈
- 295
- 마지막 커밋
- 5일 전
어떤 프로젝트인가요?
Shields.io는 상태, 버전, 다운로드 수, 커버리지 등의 지표를 보여 주는 일관되고 읽기 쉬운 배지를 제공합니다. CI 서비스, 패키지 레지스트리, 앱 스토어, 코드 분석 도구 등의 데이터 소스를 URL로 지정하면 배지가 생성되며, 이미지를 GitHub README나 다른 웹 페이지에 삽입할 수 있습니다. 이 서비스는 수십 가지 CI 서비스, 패키지 레지스트리, 배포판, 소셜 네트워크, 코드 품질 도구를 지원합니다.
이 저장소에는 Shields.io의 프런트엔드와 서버 코드, 프로그래밍 방식으로 배지를 생성하는 badge-maker NPM 라이브러리, 배지 디자인 사양이 포함되어 있습니다. 개발자는 레이블, 메시지, 색상을 지정하는 정적 URL로 사용자 지정 배지를 만들 수도 있고, Sentry와 Prometheus를 선택적으로 연동해 서버를 자체 호스팅할 수도 있습니다.
이 프로젝트는 기여자 커뮤니티가 유지 관리하며, 문서 사이트에는 Node.js와 Docusaurus를 사용합니다.
핵심 기능
- 01계정 없이 URL로 SVG 및 래스터 배지를 생성
- 02다양한 CI 서비스, 패키지 레지스트리, 앱 스토어, 코드 분석 도구 지원
- 03코드에서 배지를 생성할 수 있는 badge-maker NPM 라이브러리 제공
- 04원하는 레이블과 색상을 지정하는 사용자 지정 정적 배지 옵션 제공
- 05Sentry 및 Prometheus를 선택적으로 연동해 자체 호스팅 가능
활용 사례
- GitHub README에 빌드, 커버리지, 버전 배지 추가
- 프로젝트 홈페이지에 패키지 다운로드 수나 릴리스 버전 표시
- badge-maker를 사용해 Node.js 빌드 스크립트에서 프로그래밍 방식으로 배지 생성
- 조직 내부에서 사용할 비공개 배지 서버 호스팅
빠른 시작
- 1
선호하는 패키지 관리자를 사용해 Node 24를 설치합니다
- 2
이 저장소를 클론합니다
- 3
종속성을 설치합니다
npm ci - 4
배지 서버와 프런트엔드 개발 서버를 시작한 다음 http://localhost:3000/을 엽니다
npm start
사용 전 알아둘 점
- 개발 환경을 설정하려면 Node 24와 저장소 전체를 클론해야 합니다.
토픽
자주 묻는 질문
- shields은(는) 무엇인가요?
- Shields.io는 README와 웹 페이지에 사용할 간결한 SVG 및 래스터 상태 배지를 생성하는 서비스이자 NPM 라이브러리입니다. Shields.io는 상태, 버전, 다운로드 수, 커버리지 등의 지표를 보여 주는 일관되고 읽기 쉬운 배지를 제공합니다. CI 서비스, 패키지 레지스트리, 앱 스토어, 코드 분석 도구 등의 데이터 소스를 URL로 지정하면 배지가 생성되며, 이미지를 GitHub README나 다른 웹 페이지에 삽입할 수 있습니다. 이 서비스는 수십 가지 CI 서비스, 패키지 레지스트리, 배포판, 소셜 네트워크, 코드 품질 도구를 지원합니다.
- shields은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- shields은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- shields은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. shields의 마지막 커밋은 2026년 11월 1일입니다.
- shields은(는) 어디에 사용할 수 있나요?
- GitHub README에 빌드, 커버리지, 버전 배지 추가 프로젝트 홈페이지에 패키지 다운로드 수나 릴리스 버전 표시 badge-maker를 사용해 Node.js 빌드 스크립트에서 프로그래밍 방식으로 배지 생성 조직 내부에서 사용할 비공개 배지 서버 호스팅
- shields는 어떻게 설치하나요?
- 선호하는 패키지 관리자를 사용해 Node 24를 설치합니다 이 저장소를 클론합니다 종속성을 설치합니다: npm ci 배지 서버와 프런트엔드 개발 서버를 시작한 다음 http://localhost:3000/을 엽니다: npm start
- shields은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/badges/shields
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
프로필 README에 이미지로 삽입해 GitHub 프로필 조회 수를 표시하는 무료 호스팅 서비스입니다.
GitHub 잔디 그래프를 프로필에 삽입할 수 있는 Galaga 스타일의 우주 슈팅 GIF 또는 WebP 애니메이션으로 변환합니다.
WakaTime 코딩 통계를 생성해 GitHub 프로필 README에 텍스트나 SVG 차트로 표시하는 GitHub Action입니다.
모든 linter나 코드 분석 도구를 실행하고, 변경된 줄에 한해 결과를 GitHub, GitLab, Bitbucket 리뷰 댓글로 게시하는 Go CLI입니다.
CI에서 PR 검토 규칙을 자동화하는 Ruby 도구로, changelog나 PR 설명 작성 규칙 등을 확인합니다.