연동
GitHub
내 앱의 코드를 내 GitHub 계정의 비공개 저장소로 보내고, 원할 때마다 새 버전을 올리고, 개발자에게 코드를 넘겨 보세요.
내 앱의 코드는 내 거예요. GitHub를 쓰면 내 GitHub 계정의 비공개 저장소에 코드 사본을 보관하고, 원할 때마다 새 버전을 보내고, 개발자와 코드를 공유할 수 있어요. GitHub 내보내기는 모든 요금제에 포함되어 있고 크레딧도 쓰지 않아요.
GitHub 동기화는 이렇게 동작해요
| 하는 일 | 일어나는 일 |
|---|---|
| 프로젝트를 처음 보낼 때 | Buildliy가 내 GitHub 계정에 프로젝트 이름을 딴 비공개 저장소를 만들고(예: buildliy-candle-shop, 이미 있는 이름이면 buildliy-candle-shop-2), 최신 버전을 README와 함께 보내요 |
| Buildliy에서 계속 만들 때 | 자동으로 보내지는 건 없어요. GitHub 아이콘에 작은 점이 보이면 GitHub에 아직 없는 새 버전이 있다는 뜻이에요 |
| 최신 버전 올리기를 고를 때 | 가장 최신 버전이 새 커밋으로 저장소에 올라가요 |
| 누군가 GitHub에서 저장소를 수정했을 때 | Buildliy는 그 사람의 작업을 덮어쓰지 않아요. 내 업데이트는 풀 리퀘스트로 도착하고, GitHub에서 검토하고 병합할 수 있어요 |
GitHub에서 한 수정은 GitHub에만 남아요. Buildliy 프로젝트나 미리보기로 다시 반영되지 않아요.
GitHub를 연결하고 저장소 만들기
GitHub 아이콘 클릭하기
프로젝트를 열고 오른쪽 위에 있는 게시 옆의 GitHub 아이콘을 클릭하세요. 아직 GitHub를 연결하지 않았다면 GitHub로 이동해요.
GitHub에서 승인하기
필요하면 GitHub에 로그인하고 Buildliy를 승인하세요. GitHub에는 Buildliy가 요청하는 권한이 표시돼요. 하나는 공개·비공개 저장소 전체에 대한 접근 권한인데, 프로젝트의 저장소를 만들고 업데이트하려면 꼭 필요해요. 다른 하나는 프로필을 읽기만 할 수 있는 권한이에요. 승인하고 나면 프로젝트로 돌아와서 "GitHub가 연결됐어요. 이제 이 프로젝트를 GitHub로 보낼 수 있어요."라는 메시지가 보여요.
저장소 만들기
GitHub 아이콘을 다시 클릭하고 비공개 저장소 만들기를 고르세요. 완료된 빌드가 하나 이상 있어야 해요. 아직 없으면 먼저 만들기라고 표시돼요. 끝나면 저장소 이름과 열기 버튼이 함께 있는 "GitHub로 보냈어요" 메시지가 보여요.
관리 → 개요의 마법 도우미 아래에서 GitHub에 백업하기를 클릭해도 돼요(앱의 백엔드가 준비된 뒤에 보여요). 하는 일은 같아요. 처음에는 저장소를 만들고, 그다음부터는 저장소를 업데이트해요. 먼저 GitHub 아이콘으로 GitHub를 연결해 주세요.
새 버전 보내기
GitHub 아이콘을 클릭해서 메뉴를 열어 보세요.
- 최신 버전 올리기는 가장 최신 버전을 보내요. 보낼 내용이 있으면 메뉴에 새 변경 사항이, 없으면 최신 상태예요가 표시돼요.
- 저장소 열기는 GitHub에서 저장소를 열어요.
- GitHub 연결 해제는 Buildliy의 접근 권한을 없애요(아래 참고).
올리고 나면 다음 중 하나가 보여요.
- "최신 버전을 …에 올렸어요": 저장소가 이제 내 앱과 같은 상태예요.
- "…에 이미 최신 버전이 있어요.": 새로 보낼 내용이 없었어요.
- "GitHub에서 풀 리퀘스트를 열었어요": GitHub에서 저장소를 수정한 내용이 있어서, 내 업데이트가 풀 리퀘스트로 들어갔어요. 검토를 클릭한 다음 GitHub에서 병합하면 저장소가 최신 상태가 돼요.
저장소에 들어가는 것
- 앱의 모든 파일: 이미지도 포함돼요. 게시할 때 Buildliy가 하는 것과 같은 작은 안전 수정이 적용돼요(예를 들어 빌더의 미리보기 편집 도우미는 빠져요).
- README: 앱 이름과 설명, 게시했다면 실제 주소, 컴퓨터에서 실행하는 방법(Node.js 20 이상을 설치한 뒤
npm install,npm run dev), 필요한 설정, 그리고 Buildliy 프로젝트로 돌아오는 링크가 들어 있어요. .env.example파일: 앱이 설정(환경 변수)을 읽을 때 만들어져요. 설정 이름과 설명이 적혀 있고, 값은 절대 들어 있지 않아요.
저장소에 절대 들어가지 않는 것도 있어요.
- 비밀 값. Buildliy는 비밀 키처럼 보이는 내용이 들어 있는 코드는 올리지 않아요. 발견하면 어느 파일에 있는지 알려 주고, 다시 시도하기 전에 키를 관리 → 비밀 값으로 옮기라고 안내해요(AI에게 부탁해도 돼요). 비밀 값이나 커넥터로 저장한 키는 Buildliy에만 남아요. 비밀 값과 API 키를 참고하세요.
- 앱의 데이터. 테이블과 그 안에 저장된 모든 내용은 앱의 데이터베이스에 남아요. 새 데이터베이스에 연결하면 코드는 빈 상태로 시작해요.
- 앱의 비공개 Buildliy 키. 앱 안의 AI나 결제 같은 기본 제공 기능이 이 키를 써요. 앱이 Buildliy에서 실행될 때는 자동으로 설정돼요. 코드를 다른 곳에서 실행하면 이 키가 없어서 그 기능들이 동작하지 않아요.
Buildliy가 저장소를 업데이트할 수 없을 때
저장소가 삭제되었거나 보관 처리되었거나, 연결한 계정이 아닌 다른 GitHub 계정의 저장소이거나, 내 계정에 그 저장소에 올릴 권한이 없으면 Buildliy가 저장소 이름과 이유를 함께 보여 주며 업데이트할 수 없어요라고 알려 줘요. 이럴 때는 새 저장소 만들기를 골라서 새 비공개 저장소에 최신 버전을 보내세요. 기존 저장소는 바뀌거나 삭제되지 않아요.
개발자와 함께 작업하기
GitHub에서 접근 권한 주기
GitHub의 설정에서 개발자를 저장소에 초대하세요. 저장소는 비공개라서 초대한 사람만 볼 수 있어요.
README를 따라 하게 하기
README에 앱을 로컬에서 실행하는 방법과 채워야 할 설정이 나와 있어요. 개발자는
.env.example을.env.local로 복사해서 자기 값을 넣으면 돼요.어디서 수정할지 정하기
Buildliy는 GitHub에서 한 수정을 내 프로젝트로 가져오지 않아요. 개발자가 GitHub에서 수정하는 동안 내가 Buildliy에서 계속 만들면, 내가 올릴 때마다 풀 리퀘스트로 도착하고 개발자는 자기 작업과 함께 병합할 수 있어요.
GitHub를 쓰고 싶지 않다면 코드 탭에서 전체 코드를 ZIP 파일로 내려받을 수도 있어요. 코드 보기 및 다운로드를 참고하세요.
공유 워크스페이스에서는 코드가 워크스페이스 소유자의 GitHub 계정으로 가기 때문에, 소유자만 프로젝트를 GitHub로 보낼 수 있어요. 팀원은 GitHub 아이콘에서 연결된 저장소를 열 수 있지만, GitHub에서는 소유자가 접근 권한을 준 사람에게만 그 저장소가 보여요.
GitHub 연결 해제하기
GitHub 아이콘을 클릭하고 GitHub 연결 해제를 고른 다음 확인하세요. 그러면 Buildliy가 모든 프로젝트에서 내 GitHub 계정에 접근할 수 없게 되고, 지금까지 갖고 있던 권한도 취소돼요. 저장소와 그 안의 코드는 GitHub에 그대로 남고, 각 프로젝트도 자기 저장소와 계속 연결돼 있어요. 다시 연결하기 전까지는 연결된 프로젝트의 GitHub 메뉴에 GitHub를 연결해서 올리기가 표시돼요. 언제든 다시 연결할 수 있고, 다른 GitHub 계정으로 연결해도 돼요.