# GitHub에서 컬렉션 가져오기
공개 GitHub 저장소에 컬렉션 파일을 두면 주소로 가져올 수 있습니다. Git 저장소 전체를 복제하는 방식은 아닙니다.

## 가장 간단한 저장소 구성
기본 브랜치의 루트에 `collection.json`을 둡니다.

```text
my-collection/
  collection.json
  assets/
    <이미지 SHA-256>/
      diagram.png
```

이미지가 없다면 `collection.json` 하나면 됩니다. [예제 파일](/downloads/collection.json)을 내려받아 저장소 루트에 올린 뒤 시작할 수 있습니다.

## 앱에서 추가하기
1. 공개 저장소 주소를 복사합니다.
2. **내 컬렉션 → 가져오기 → 링크**를 엽니다.
3. 주소를 붙여 넣고 **가져오기**를 누릅니다.

다음 세 형식을 지원합니다. 아래 `OWNER`와 `REPOSITORY` 등은 본인의 값으로 바꿔 주세요.

```text
https://github.com/OWNER/REPOSITORY
https://github.com/OWNER/REPOSITORY/blob/main/collection.json
https://raw.githubusercontent.com/OWNER/REPOSITORY/main/collection.json
```

저장소 주소만 넣으면 기본 브랜치의 `/collection.json`을 읽습니다. 다른 이름이나 폴더의 JSON은 해당 파일의 blob 주소나 raw 주소를 사용하세요. HTTPS 공개 주소를 사용하고 query·fragment가 붙은 링크는 피하세요. 비공개 저장소 인증과 GitLab 등의 다른 Git 서비스는 현재 이 가져오기 경로에서 지원하지 않습니다.

## 이미지 경로
JSON의 assets에 선언한 상대 경로를 JSON 파일 위치를 기준으로 찾습니다. 파일은 JSON과 같은 디렉터리 또는 그 아래에 있어야 합니다. 이미지의 실제 SHA-256, 경로, 참조가 일치해야 합니다.

[이미지 자산 규칙](/ko/docs/protocol/media/)

## 저장소를 바꾸면 앱도 바뀌나요?
GitHub에 변경을 올린 뒤 **같은 파일 주소**로 다시 가져오면 앱이 원본을 확인합니다. 원본의 카드 추가·수정·삭제를 반영하며, 공통 기준을 확인할 수 있으면 서로 겹치지 않는 기기 편집도 함께 유지합니다.

원본과 기기에서 같은 내용을 다르게 수정했거나 기존 사본의 기준을 확인할 수 없으면 **내 컬렉션 → … → 원본 변경 검토**에서 차이를 확인하세요. 적용 전까지 현재 컬렉션은 그대로 유지됩니다. 편집 중인 초안이 있다면 먼저 마무리한 뒤 원본을 적용할 수 있습니다.