러버블 깃허브 연동, 코드 내 것으로 가져오기

러버블 프로젝트를 깃허브에 연결하면 러버블이 내 깃허브 계정이나 조직에 새 저장소를 만들고, 러버블에서 고친 내용과 저장소에 올린 내용이 서로 따라가는 양방향 동기화가 시작됩니다. 저장소는 기본으로 비공개입니다.

깃허브의 저장소(repository)는 GitHub 공식 문서의 설명으로 코드와 파일, 파일별 수정 이력을 저장하는 곳입니다. 러버블 코드를 이 저장소로 옮기는 방법을 2026년 11월 5일 러버블과 GitHub 공식 문서 기준으로 정리했습니다.

영어 원문은 우리말로 옮겼습니다. 메뉴 이름은 원문 그대로 적었고, 파일 크기나 시간 같은 숫자는 쓰지 않았습니다.

1. 러버블 코드를 깃허브로 가져올 수 있나요?

네. 러버블 문서에 따르면 프로젝트 코드는 처음에 러버블 안에서 저장되고 관리됩니다. 내 사본이 필요하거나 개발자와 협업하거나 다른 곳으로 옮길 계획이면 깃허브로 내보내고 동기화할 수 있다고 합니다.

러버블 프로젝트를 깃허브에 연결하면 러버블이 새 저장소를 만들어 코드를 담고, 그 뒤로 양쪽이 자동으로 동기화됩니다. 이미 있는 저장소를 고르는 방식은 아닙니다.

러버블 문서는 이 연동이 지원하지 않는 것으로 이미 있는 저장소에 프로젝트를 연결하는 일을 꼽습니다. 연동은 늘 새 저장소를 만들고, 저장소의 코드로 시작하려면 저장소를 ZIP 으로 받아 프로젝트로 가져오는 방법을 안내합니다.

2. 「코드가 내 것」이라는 말은 어디까지인가요?

러버블의 소유권 문서는 이렇게 적었습니다(영어 원문).

Your apps, code, and content you create with Lovable are yours, subject to third-party rights such as open-source licenses.

내가 만든 앱과 코드와 내용은 내 것이지만, 오픈소스 라이선스 같은 제3자의 권리는 따로 적용된다는 뜻입니다. 이 글이 말하는 「내 것으로 가져오기」는 저장소에 코드가 생겨 내 계정에서 관리된다는 범위까지입니다.

깃허브가 꼭 필요한 것은 아닙니다. 문서는 깃허브 없이 러버블 안에서 만들고 공개하는 사용자도 많다고 적었습니다. 코드 사본만 필요하면 Project settings → Git 의 Download codebase 로 받을 수 있고, 이 버튼은 문서에 유료 요금제로 표시되어 있습니다.

3. 깃허브에 연결하는 순서

연결은 두 층입니다. 먼저 작업 공간(워크스페이스)이 러버블 GitHub 앱을 통해 내 깃허브 계정이나 조직에 접근하도록 허락하고, 그다음 프로젝트 하나를 저장소 하나에 잇습니다. github.com 연결은 모든 요금제에서 쓸 수 있고 깃허브 계정이 필요합니다.

1. 작업 공간 소유자나 관리자가 Workspace settings → Git → GitHub → Add connection 으로 들어갑니다
2. Add account 를 누르면 깃허브 창이 열립니다. 계정이나 조직을 고르고 All repositories 또는 Only select repositories 를 고른 뒤 Install & Authorize 를 누릅니다
3. 프로젝트의 Project settings → Git → GitHub 로 가서 연결된 계정 옆의 Connect 를 누릅니다
4. 러버블이 새 저장소를 만들고 양방향 동기화를 자동으로 시작합니다

작업 공간 연결을 만들거나 고치는 일은 작업 공간 소유자나 관리자만 할 수 있다고 문서가 적었습니다. 프로젝트를 저장소에 잇는 일은 작업 공간이나 프로젝트의 관리자와 소유자가 합니다.

4. 연결한 뒤 코드는 어떻게 움직이나요?

러버블에서 바꾼 내용은 깃허브로 올라가고, 동기화 중인 깃허브 브랜치(저장소 안의 갈래)에 올린 내용은 러버블로 돌아옵니다. GitHub 공식 문서는 브랜치를 저장소 안에 있으면서 기본 브랜치에는 영향을 주지 않는 코드의 병렬 버전으로 설명합니다.

러버블은 한 번에 한 브랜치만 편집하고 동기화하므로, 다른 브랜치에 올린 내용은 동기화 브랜치에 합치거나 동기화 브랜치를 바꿔야 러버블에 나타납니다. 기본값은 저장소의 기본 브랜치이고 보통 main 입니다.

내 컴퓨터에서 고치고 싶으면 저장소를 복제(clone)합니다. GitHub 공식 문서는 복제를 모든 파일 버전을 포함한 저장소 전체 사본을 받는 것으로 설명하고, 러버블은 HTTPS, SSH, GitHub CLI 세 가지 복제 주소를 제공합니다.

복제는 코드만 주고 앱이 부르는 서비스는 주지 않는다고 러버블 문서가 밝혔습니다. 또 동기화 브랜치에 이미 올라간 커밋(변경 기록)에는 강제 푸시, 리베이스, 스쿼시(커밋 합치기)를 하지 말라고 안내합니다.

깃허브가 러버블의 올리기를 거절하면, 대표적으로 브랜치 보호 규칙 때문에, 러버블은 작업이 사라지지 않게 lovable-sync 브랜치에 올립니다. 그 브랜치를 검토해 보호된 브랜치에 합치라고 문서가 안내합니다.

5. 연결 전에 알아 둘 제약

문서가 지원하지 않는다고 적은 것은 세 가지입니다. 이미 있는 저장소에 프로젝트를 연결하는 것, 연결을 끊은 뒤 같은 저장소에 다시 연결하는 것, 같은 계정이나 조직에 러버블 GitHub 앱을 여러 번 설치하는 것입니다.

연결을 끊으면 동기화가 멈춥니다. 저장소는 모든 이력과 파일 그대로 깃허브에 남고, 프로젝트와 코드는 러버블에 남아 이후 변경은 러버블 안에만 저장됩니다. 다시 연결하면 러버블이 현재 버전으로 새 저장소를 만듭니다.

깃허브의 저장소를 지우지 말라는 경고도 있습니다. 지우면 동기화가 멈추고, 저장소나 계정, 조직의 이름을 바꾸는 것은 동기화를 멈추지 않는다고 문서가 적었습니다.

6. 깃허브를 잘 몰라도 쓸 수 있나요?

네. 러버블 문서의 FAQ 가 이렇게 답합니다(영어 원문을 옮겼습니다). 한 번 연결해 두면 깃허브가 코드를 안전하게 보관하고, 브랜치, 풀 리퀘스트, CI/CD 같은 고급 기능은 쓰고 싶을 때만 배우면 됩니다.

풀 리퀘스트는 GitHub 공식 문서에서 한 브랜치의 변경을 다른 브랜치에 합치자는 요청으로 설명합니다.

러버블 밖에서 앱을 배포하는 방법은 러버블의 「Deploying and hosting outside Lovable」 문서에 따로 있습니다.

문서는 앱에 따라 서버 코드를 돌리는 앱도 있다고 설명하므로, 깃허브 페이지 같은 곳에 그대로 올려도 되는지는 확인이 필요합니다. 일반적인 방법은 깃허브로 웹사이트 무료 배포하기에 정리했습니다.

7. 정리하면 이렇게 가져옵니다

1. 깃허브 계정을 준비하고, 작업 공간 소유자나 관리자가 러버블 GitHub 앱 연결을 만듭니다
2. 프로젝트에서 Connect 를 눌러 새 저장소를 만들고 동기화를 시작합니다
3. 다른 브랜치에서 고쳤다면 동기화 브랜치에 합칩니다
4. 코드 사본만 필요하면 Download codebase 를 씁니다(유료 요금제로 표시)

코드와 저장소를 직접 다루는 일이 부담스럽다면, 이 블로그를 운영하는 AiApp에서는 만들고 싶은 것을 말로 설명하면 AI가 기획서를 쓰고 화면과 기능을 만들어 줍니다.

업종별 템플릿에서 시작해 대화로 바꾸거나 에디터에서 드래그 앤 드롭으로 직접 고칠 수 있고, 클릭 한 번으로 실제 주소에 공개합니다. 템플릿은 템플릿 페이지에서 볼 수 있습니다.

러버블 첫 사용 순서는 러버블 사용법, 첫 화면부터 배포까지에, 다른 도구와 비교는 AI 코딩 툴 설치 총정리와 다른 묶음의 AI 코딩 도구 총정리에 있습니다.

참고자료 (모두 2026년 11월 5일 확인)

• Lovable Docs 「Sync your Lovable project with GitHub」 — docs.lovable.dev/integrations/github
• Lovable Docs 「Sync your Lovable project code with GitHub, GitLab, or Bitbucket」 — docs.lovable.dev/integrations/git-sync-overview
• Lovable Docs 「Deployment, hosting, and ownership options with Lovable」 — docs.lovable.dev/tips-tricks/deployment-hosting-ownership
• Lovable Docs 「Deploying and hosting outside Lovable」 — docs.lovable.dev/tips-tricks/external-deployment-hosting
• GitHub Docs 「About repositories」 — docs.github.com/…/about-repositories

#러버블깃허브 #러버블 #깃허브연동 #바이브코딩 #AI코딩도구