콘텐츠로 이동

GitHub 동기화

Piko에서 만든 앱은 유료 플랜에서 코드를 GitHub 리포지토리와 동기화해 직접 이어서 작업할 수 있습니다. 결과물은 React·TypeScript·Tailwind 코드입니다. 현재 GitHub 동기화는 프로젝트 소유자가 버튼으로 실행하는 수동 동기화 방식입니다.

현재 가능한 것

기능	상태
처음 GitHub 리포지토리 만들기	지원
Piko에서 GitHub로 다시 동기화	지원
GitHub 변경을 Piko로 가져오기	지원
원격 저장소 변경 상태 확인	지원
양쪽 변경 충돌 안내	지원
덮어쓰기 전 GitHub 백업 브랜치 생성	지원
무료 플랜에서 소스 복제·GitHub 동기화	미지원
PR/branch 중심 협업	로드맵
자동 백그라운드 동기화	로드맵

소스 공개와 앱 공개

앱 화면 공개와 소스 공개는 다른 설정입니다.

앱 화면 공개 — 방문자가 slug.piko.kr 사이트를 볼 수 있습니다.
소스 공개 — 다른 사람이 앱 소스를 복제할 수 있습니다.
소스 공개 기본값은 비공개입니다.
소스 공개, 소스 복제, GitHub 동기화는 유료 플랜 기능입니다.
유료 플랜에서도 앱 소유자가 명시적으로 소스 공개를 켠 경우에만 다른 사람이 공개 소스를 복제할 수 있습니다.

처음 연결하기

프로젝트 소유자가 채팅 화면에서 GitHub 동기화를 시작합니다.
GitHub 계정 연결(권한 승인)을 진행합니다.
Piko가 리포지토리를 만들고 코드를 올립니다.

진행 상태(대기 → 진행 → 완료)가 표시됩니다.

Piko에서 GitHub로 동기화하기

이미 연결된 저장소가 있으면 같은 버튼이 GitHub에 동기화 흐름으로 바뀝니다.

Piko의 최신 파일을 연결된 GitHub 저장소에 올립니다.
GitHub에 Piko가 모르는 새 커밋이 있으면 먼저 충돌 위험을 안내합니다.
사용자가 덮어쓰기를 선택하면 원격 작업을 piko-backup-<시각> 브랜치로 보관한 뒤 진행할 수 있습니다.

로컬에서 수정하기

GitHub로 내보낸 뒤에는 리포지토리를 내 컴퓨터로 복제해 VS Code, Cursor, Claude Code, Codex 같은 도구에서 이어서 작업할 수 있습니다.

도구별 버튼이나 로그인 절차는 각 제품에서 자주 바뀌므로, Piko 문서에서는 공통 흐름만 안내합니다. → 로컬에서 이어서 작업하기

GitHub에서 Piko로 가져오기

GitHub 리포지토리에 올라간 변경을 Piko로 다시 가져올 수 있습니다. 가져오면 Piko의 파일 상태가 갱신되고 보기 탭을 다시 빌드합니다. 공개 사이트에 반영하려면 별도로 변경사항 반영을 실행해야 합니다.

충돌이 생기면

Piko와 GitHub 양쪽이 모두 바뀐 경우 Piko는 자동 병합하지 않고 충돌을 안내합니다.

GitHub 걸로 가져오기 — Piko 쪽 변경을 버리고 GitHub 상태로 보기 탭을 갱신합니다.
빌더 걸로 덮어쓰기 — GitHub 현재 브랜치를 백업한 뒤 Piko 상태를 저장소에 올립니다.

알아둘 점

Piko 안의 작업 상태와 GitHub 리포지토리는 서로 다른 저장소입니다. 그래서 일반 Git처럼 공통 조상을 기준으로 자동 병합하지 않고, 현재 파일 상태를 기준으로 동기화합니다.

GitHub에서 가져올 때 바이너리 파일은 빌더 코드로 읽지 않습니다.
저장소가 너무 크거나 파일이 너무 많으면 가져오기가 제한될 수 있습니다.
Piko로 가져온 변경은 보기 탭을 갱신하지만, 공개 사이트는 다시 배포해야 바뀝니다.